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SYSTEM INSTALLATION 


Preface 


This manual is one of a series designed to instruct and guide the system administrator 
in the use of the SPERRY UNIVAC Operating System/3 (OS/3). This manual specifically 
describes the system generation (SYSGEN) procedure. It does not, however, describe in 
detail all of the components of OS/3. For this reason, you should familiarize yourself 
with the appropriate manuals in the OS/3 library before you begin to specify the size or 
type of system that you want to install. 


An introductory manual, the introduction to system installation, UP-8077 (current 
version), briefly describes the general characteristics of OS/3 SYSGEN. 


This manual is divided into the following parts: 


m PART 1. INTRODUCTION TO SYSTEM GENERATION 


Part 1 defines system generation, its design concepts, and what you must consider 
to properly use it. 


m PART 2. KEYWORD PARAMETER SPECIFICATIONS 


Part 2 defines the keyword parameters available for generating a supervisor, 
defining the input/output device configuration for the generated supervisor, creating 
your own system resident (SYSRES) volume, configuring an emulator or 
communications load module, and specifying default options for the COBOL 
compiler. 


=m PART 3. SYSGEN EXAMPLES, OPERATING PROCEDURES, AND STATEMENT 
CONVENTIONS 


Part 3 gives coding examples of system generation and operating procedures 
enabling you to do a complete SYSGEN, including post-generation procedures. In 
addition, we provide a procedure for the system administrator to change the 
system bulletin. And we provide procedures for installing system maintenance 
packages. Part 3 also gives the conventions used to delineate the configuration 
parameter values in this manual. 


OS/3 is the operating system for the 90/25, 90/30, 90/30B, and 90/40 data 
processing systems. In general, the specifications, procedures, and descriptions 
contained herein apply to any of these systems; however, there are some exceptions or 
restrictions. Because some devices are restricted to certain models, parameters for 
those devices apply only to those models. In the few cases where the requirements 
differ, the exceptions are noted. 
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1. Introduction 


1.1. WHAT IS SYSTEM GENERATION? 


System generation is the process by which you install, update, and tailor your SPERRY 
UNIVAC Operating System/3 (OS/3) software. It is the process that allows you to 
create an operating system that meets the specific needs of your facility. 


The system generation (SYSGEN) procedures we provide in this manual allow you to: 
m= generate new supervisor configurations; 


m= define new input/output device configurations to complement both new and 
existing supervisors; 


= tailor the system software residing on your existing system resident (SYSRES) 
volume; , 


= configure executable modules for emulation, communication, and 
nine-thousand-remote (NTR) networks; and 


m redefine standard option default values for the American National Standard 1974 
COBOL (ANSI'74) compiler. 


With OS/3, you have the option of performing a SYSGEN in either a batch or an 
interactive environment. In the batch environment, in which OS/3 has. traditionally 
operated, you enter the parameters defining your SYSGEN requirements on cards or 
card images on diskettes. In an interactive environment, you no longer prepare punched 
cards or diskettes to input and process your SYSGEN parameters. Instead, you enter 
these parameters directly from a workstation or a remote communications terminal. (In 
this manual, references to workstations include both local workstations and remote 
terminals that use interactivity through a communications network.) 


To familiarize yourself with the SYSGEN process, see Figure 1—1 for an overview of the 
major areas you must consider when performing system generation. 
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Figure 1—1. Overview of Requirements for SYSGEN 
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System generation is designed for ease of use. As such, Sperry Univac supplies several 
SYSGEN facilities to simplify your effort. Our objective is to make your SYSGEN as easy 
as possible to perform and to minimize the amount of coding and procedural definition 
you must provide. This design, however, does not prevent those of you who want to 
exercise greater control over the SYSGEN process from doing so. That is, you can 
define the details that goven specific SYSGEN processes. You decide how you want 
your operating system configured and then perform those phases of SYSGEN that you 
need to accomplish your goal. 


1.2. HOW DO YOU ORDER OS/3? 


You can order OS/3 software on one of two types of media: either a dump/restore 
tape or a disk volume. Those of you who order OS/3 on disk can immediately use the 
OS/3 release volume (OS/3REL) we deliver as input for SYSGEN. Tape delivery, 
however, does not offer this advantage. That is, if you receive your OS/3 software on 
tape, you must first copy it to a disk to create an OS/3REL volume before you can use 
it as SYSGEN input. Of course, you must have an existing OS/3 operating system to 
run the dump/restore job control stream that transfers the tape’s contents to disk. We 
give the instructions for dumping your release tape to disk in 10.2. 


You can also order separately-priced program products and programming aids (optional 
software) to complement your system's operation. This software comes on tape or 
disk. If you order optional software at the same time as you order your OS/3 release 
software, we deliver the optional software on the same media as your release software. 
If, however, you order optional software between major OS/3 releases, we deliver it 
either on tape or disk, according to how you order it. 


To help you install optional software products into your system, we provide a prefiled 
job control stream called SGSCPYPD that allows you to install those products from 
either type of media directly to the disk serving as your SYSRES. And it is capable of 
installing one or several products in one execution. We describe the procedure for 
installing separately-delivered program products in 10.3. 


At regular intervals, we deliver system maintenance packages (SMPs) on tape or disk, 
depending on your hardware configuration, for you to install in your system. SMPs 
contain changes to OS/3 software that we find necessary to maintain the software's 
effectiveness. To install them, we provide system maintenance installation- routines, 
which we describe in detail in Section 11. The SMP installation routines let you install 
SMPs from the SMP release media to the OS/3REL. 
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1.3. HOW DO WE SIMPLIFY SYSGEN? 


Sperry Univac simplifies SYSGEN by including, as part of each OS/3 release, all of the 
SYSGEN software you need to install, update, and tailor the system software for your 
facility. 


We supply the SYSGEN parameter processor to accept your parameter choices and 
actually process them. Based on your selections, the parameter processor prepares a 
listing that includes parameter specifications, error diagnostics, and instructions. If you 
omit parameters or incorrectly specify any, it supplies default values for those 
parameters and includes those default values in its listing, as well. Therefore, you can 
correct or change parameters before processing them. The parameter processor also 
lists the names of the OS/3 job control streams that you must run to perform your 
system generation. 


We also supply prefiled SYSGEN job control streams to simplify the process of 
transferring your newly configured software onto your system resident (SYSRES) 
volume. The use of prefiled job control streams eliminates the need for you to know the 
OS/3 job control language (JCL) before attempting to generate your system. 


lf you are an interactive user, we've further simplified SYSGEN by providing a facility 
called the SYSGEN dialog to help you prepare and process your SYSGEN parameters. It 
is easy to use, helps you avoid common SYSGEN errors, and adapts readily to different 
kinds of users. By offering you only valid parameter choices, the SYSGEN dialog always 
produces syntactically correct output for the parameter processor. 


To make certain that your SYSGEN is successful, we provide a complete set of 
installation verification procedures (IVPs). These procedures verify that your SYSGEN 
operation correctly installed all of your software onto your SYSRES. The installation 
verification procedures user guide/programmer reference, UP-8820 (current version) 
discusses IVPs and their use in detail. 


1.3.1. Job Control Streams 


The names and functions of the system-supplied SYSGEN job control streams are as 
follows: oo 


= SG$BLD 


Interactive users run this job control stream from the workstation to use the 
SYSGEN dialog. It initiates the dialog processor, which displays the SYSGEN dialog 
on the workstation screen, accepts your parameter choices and selections, stores 
these parameter sets until the parameter processor needs them, and executes the 
parameter processor, if you are ready to process your parameters. 
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SG$PARAM 


This is the job control stream you run to process your SYSGEN parameter 
definitions. It executes the parameter processor, which verifies your SYSGEN 
parameter definitions and lists all of the additional job streams that need to be run, 
as well as your parameter specifications, defaults, and error diagnostics. 


SGSPREP 


This is the first job control stream listed in the output listing prepared by the 
parameter processor if a new SYSRES volume is being created. That is, you are 
writing the output of your SYSGEN to any output disk volume other than the 
current OS/3REL volume or your present SYSRES volume. SG$PREP initiates the 
routine that preps the disk volume to serve as your remodeled SYSRES. It copies 
the control storage code (COS) records, the initial program load (IPL), and boot 
block records to that disk and creates the volume table of contents (VTOC). The 
extent of disk preparation is determined by the options you select when specifying 
the parameters for generating a new SYSRES volume (RESGEN section of SYSGEN). 


SG$ASG 


This job control stream is required only if a new SYSRES is being created and must 
be run after the completion of SGSPREP. It initiates the routine that allocates space 
for the system libraries and transient file. 


SGSTRANS 


This job control stream is also required if a new SYSRES is being created and must 
be run upon completion of SG$ASG. It initiates the routine that transfers the 
transient library modules from the OS/3REL volume to your remodeled SYSRES 
volume. When the OS/3REL is also your current SYSRES, do not run SG$TRANS in 
a multiprogramming environment. 


SG$LIB 


This job control stream is also required if a new SYSRES is being created and must 
be run upon completion of SGSTRANS. It initiates the routine that transfers the 
system library modules from the current OS/3REL volume to your remodeled 
SYSRES volume. 


SG$SUPMK 
This job control stream initiates the routine that generates your supervisor 


configurations, and stores them in the system load library file (SYSLOD) of the new 
SYSRES volume or the OS/3REL volume. 
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SG$LIB2 (only for 8415 disk secondary release volumes) 


If you are operating with an 8415 disk, the OS/3SREL volume is contained on the 
removable disk pack. In this case, either one, two, or three volumes are needed, 
depending on the operating system you intend to generate. 


The first 8415 removable disk pack, called the primary release volume, contains the 
bulk of the operating system modules (basic system modules, assembler, linker). 
These are copied to the output SYSRES when you run SG$LIB. 


lf, however, your system requires any of the modules not contained on the first 
volume, you will need either the second 8415 removable disk pack, called the 
secondary volume, or the third removable disk pack, called the tertiary volume. The 
software release document (SRD) that eon panes your OS/3REL lists the disks 
that contain specific system modules. 


When you mount the 8415 disk secondary volume, use the SG$LIB2 job control 
stream to copy the system components that you need from that volume. The 
secondary volume contains all of the language processor modules. Either the 8415 
disk primary release volume or the output SYSRES may function as the IPL volume. 


SG$LIB3 (only for 8415 disk tertiary release volumes) 


If your system requires any of the program modules not contained on the first or 
second volumes, you will need the third 8415 removable disk pack, called the 
tertiary volume. When you mount the third disk pack, use the SG$LIB3 job control 
stream to copy the remainder of the system components from the tertiary release 
volume. Either the 8415 primary disk pack or the output SYSRES may function as 
the IPL volume. 


lf you do not need the modules on either the secondary or the tertiary volumes, 
you do not need to run the job control streams that copy those modules. Therefore 
you should order only the-8415 removable disk packs that contain the modules 
needed for your particular SYSGEN. 


SGSEMUMK 


This job control stream initiates the routine that creates and transfers your 
configured emulator and/or tape loop definition load modules to your remodeled 
SYSRES or the OS/3REL volume. 


SG$SEMJCL 
This job control stream initiates the routine that lists on the printer, and/or punches 


on cards, the necessary job streams to run your configured emulator. (This job 
control stream may be executed before or after completion of the SGSEMUMK job.) 


@ 
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SGSCOMMK 


This job control stream initiates the routine that creates and transfers the integrated 
communications access method (ICAM) load module to your remodeled SYSRES or 
the OS/SREL volume. 


SGSNTRMK 


This job control stream creates a nine thousand remote (NTR) system utility load 


module and stores it in the $Y$LOD library of your output SYSRES or the OS/3REL 
volume. | 


SG$PRB 


This job control stream is used to equate your nonstandard printer character set 
and vertical format characteristics to your operating system. It processes the // 
LCB (load code buffer) and // VFB (vertical format buffer) job control statements 
used for defining your printer requirements and loads the appropriate printer 
buffers. If none of the printers in your system is a Sperry Univac 0768, 0770, 
0773, O776, or O778 subsystem that uses either a 63-character standard, 
48-character business, or 48-character scientific print set, this job control stream 
must be run before the parameter processor job (SG$PARAM) can be called in. 
Otherwise, it may be used in a utility function for the purpose specified. 


SGSCATCP 


This job control stream allows you to copy the catalog file from an existing 
SYSRES volume to the SYSRES volume being created. 


SGSCOBMK 


This job control stream allows you to configure processing options for the ANSI'74 
COBOL compiler different from the compiler’s standard default values. 


1.3.2. The SYSGEN Dialog 


The SYSGEN dialog is an easy-to-use facility that helps you prepare and process your 
SYSGEN parameters or requirements. At your workstation, the SYSGEN dialog: 


1. 


displays questions, menu choices, explanations, and HELP screens concerning the 
various SYSGEN options; 


accepts your answers and choices; 
stores your parameters until you are ready to process them; and 


executes the SYSGEN component that processes your parameters (the SYSGEN 
parameter processor). 


UP-8074 Rev. 11 SPERRY UNIVAC OS/3 1-8 
SYSTEM INSTALLATION 


From screens displayed at the workstation, you read explanations, questions, and & 
menus — groups of options from which you choose the ones you want. If you need 

more information about a particular parameter to make a valid choice, you can request 

help. The dialog then shows a screen providing detailed explanations of that parameter. 

After it displays a HELP screen, the dialog resumes where it left off. 


This flexibility allows an experienced SYSGEN user to build parameter sets quickly and 
easily, receiving help only when. he needs it. Users less familiar with SYSGEN can use 
the HELP screens to learn about SYSGEN as the dialog guides them in building valid 
parameter sets. The following screens show typical examples of the first screen of the 
SYSGEN dialog and a sample HELP screen. 







PROGRAM=DIALOG FOR SYSTEM GENERATION 


THE DIALOG FOR SYSTEM GENERATION IS A 
COMPUTER ASSISTED METHOD FOR PREPARING 
SYSGEN PARAMETER SETS. FOR A 
DESCRIPTION OF THE DIALOG PROCESS. 
ENTER ''HELP'' IN THE SPACE PROVIDED. 









THE DIALOG METHOD USES THE COMPUTER TO 
ASSIST YOU IN PREPARING PARAMETER SETS 

BY PROVIDING EXPLANATIONS AND PROMPTING 
FOR DATA ENTRY. AS PARAMETERS ARE NEEDED, 
THE DIALOG PROCEEDS UNTIL A COMPLETE 
PARAMETER SET HAS BEEN GENERATED. ALL THE 
PARAMETERS ARE VERIFIED BY THE USER BEFORE 
THEY ARE OUTPUT FOR USE BY THE SYSGEN 
PARAMETER PROCESSOR. PARAMETERS ARE 


SPECIFIED EITHER BY SELECTING OPTIONS 
FROM A MENU OR BY ENTERING DATA DIRECTLY 
FROM A WORKSTATION. 
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According to what you want your system to accomplish, you select the phases of 
SYSGEN that you want to perform by responding to a menu screen similar to the 
following one. We describe these phases in detail in Part 2. 


SELECT THE SYSGEN PHASE TO BE PREPARED: 


SUPERVISOR GENERATION (SUPGEN and IOGEN) 
ICAM MODULE GENERATION (COMMCT) 

COBOL COMPILER OPTIONS SPECS (COBGEN) 
NTR UTILITY GENERATION (NTRGEN) 

SYSTEM RESIDENT VOLUME CREATION CRESGEN) 


NO FURTHER PHASE REQUIREMENTS 

DISPLAY PHASE DESCRIPTIONS 

CENTER NUMBER FOR SINGLE PHASE OR 
'THELP'!' FOR ALL PHASES) 


ENTER CHOICE BY NUMBER 





From this point on, the SYSGEN dialog displays only those screens that pertain to the 
SYSGEN phases you select. These screens display the parameter choices for each 
selected section, explain your options in specifying parameters, and give the parameter 
default values. You may want to specify values for some parameters, but keep in mind 
that OS/3 provides default values that create a workable system and are usually 
sufficient. At the end of each section of related SYSGEN parameters, the dialog shows 
a list of the selections you chose. You then have a choice of three actions: 


1. to accept the list as it Is; 
2. to correct or change a selection; or 
3. to completely erase and ignore a parameter set that you mistakenly specified. 


After you respond to the choice at the end of each parameter section, you move on to 
the next set of parameter statements. By offering you this chance to doublecheck your 
choices, and by displaying only those parameters that apply to you, the SYSGEN dialog 
helps you to avoid common SYSGEN errors. 


You may also request that your system save a record of your dialog sessions, in case 
you want to change your SYSGEN parameters. The dialog saves this record in a dialog 
audit file and provides a printed summary listing that you can use as a map to the audit 
file. 


After you respond to all of the phases of SYSGEN that the dialog has displayed, you 
receive a system message at the workstation informing you that the dialog session is 
comptete. The SYSGEN dialog then asks whether you want it to execute the parameter 
processor. If you are satisfied with your parameter choices and are ready to process 
them, you direct the SYSGEN dialog to execute the parameter processor for you. 
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1.4. YOUR RESPONSIBILITIES 


Your responsibilities in preparing for and performing a SYSGEN procedure consist of the 
following 10 items: 


1; 


10. 


If your OS/3 software release is on tape, copy that software to the disk that will 
serve as your OS/3 release volume (OS/3REL) during SYSGEN. Complete this 
procedure before you attempt SYSGEN. See subsection 10.2 for instructions to 
dump release software on tape to disk. You do not have to perform this step if we 
delivered your OS/3 release software on disk. This disk is your OS/3REL; 
therefore, you can use it as SYSGEN input immediately. 


Install any separately-delivered program products and programming aids that you 
ordered between major OS/3 software releases onto your existing SYSRES volume. 
Subsection 10.3 gives the instructions for installing separately-delivered OS/3 
software. You must complete this operation before going on to SYSGEN. 


Prepare a backup copy of your software release volume (OS/3REL). Although this 
step is not required, we recommend it. Use the job control streams that we 
provide for this purpose. Subsection 10.4 describes the procedures for making a 
backup copy of your OS/3REL volume. 


Determine what phases of SYSGEN must be executed to configure the system 
software required to operate your system in a batch or interactive environment. 


Determine how you plan to integrate the system software supplied on the OS/3REL 
volume into your system. (This is dictated by the software level of the OS/3REL 
volume aS compared to your existing SYSRES volume and your hardware 
configuration.) 


Prepare the configuration parameter statements that define the SYSGEN phases to 
be executed as well as specifications to which each SYSGEN phase executed must 
conform. 


Initiate the SYSGEN procedure. 


Run the SYSGEN job control streams in the sequence listed in the output listing 


prepared by the parameter processor and output on the system printer or 
workstation screen. 


Verify that your SYSGEN was successful by running the IVPs described in the 
installation verification procedures user guide/programmer reference, UP-8820 
(current version). | 


Prepare a backup copy of your newly configured SYSRES volume. This step, also, 
is not required for SYSGEN. However, we recommend that you backup your 
SYSRES using the job streams that we supply for this purpose. Subsection 10.4 
gives the procedures for making a backup copy of your SYSRES. 


In addition, you are responsible for installing system maintenance packages (SMPs) as 
Sperry Univac delivers them at regular intervals. Section 11 describes SMPs in full detail 
and gives the procedures for installing them. 
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1.4.1. Determining the Phases of SYSGEN to Be Performed 


This is the initial step in performing a SYSGEN. You must determine exactly what you 
want to accomplish through the performance of SYSGEN. The first requirement is that 


you ask, ‘‘Is it necessary for me to perform a SYSGEN?”’ If you answer ‘‘yes”’ to any of 


the following questions, then you need to perform a SYSGEN: 


Are you installing an operating system for the first time? 


Do you want to update your existing SYSRES volume to the level of the current 
OS/3REL volume? | 


Do you want to add new supervisor configurations to your existing operating 
system? | 


Do you want to remodel your existing SYSRES volume? 

Do you want to configure a SPERRY UNIVAC 9200/9300 or IBM 360/20 emulator? 
Do you want to configure an ICAM module? 

Do you want to configure an NTR system utility module? 


Do you want to configure options for the ANSI’'74 COBOL compiler? 


The exact phases of SYSGEN to be executed depend on which specific questions you 


have answered “yes”. 


To help clarify this, let’s define each of the phases comprising the SYSGEN procedure. 


SUPGEN 


This phase allows you to generate a supervisor tailored to your particular needs by 
selecting those features you want included for your system. The SUPGEN phase 
must be followed by an I/OGEN phase. 


|/OGEN 

This phase allows you to define your specific input/output device configuration to 
the supervisor generated by SUPGEN. This phase must immediately follow a 
SUPGEN phase to form a complete supervisor configuration definition. 


RESGEN 


This phase allows you to generate a new SYSRES volume tailored to your 
specifications. It must follow an |/OGEN phase. 
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EMULAT 


This phase allows you to configure either a SPERRY UNIVAC 9200/9300 emulator 
or an IBM 360/20 emulator and prepare tape loop definitions. It may be executed 
along with a supervisor generation or as a separate function of the SYSGEN 
procedure. 


COMMCT 


This phase allows you to configure an ICAM load module. It also may be executed 
with a supervisor generation or as an individual function. 


NTRGEN 


This phase allows you to configure an NTR system utility module so that a SPERRY 
UNIVAC 90/30 Data Processing System can be used as a remote device by a 
SPERRY UNIVAC 1100 Series Data Processing System. An NTR module cannot be 
used without an ICAM load module being available to support the NTR network. 


COBGEN 


This phase allows you to configure processing options for the ANSI’74 COBOL 
compiler different from the compiler’s standard default values. 


For batch users, the SYSGEN phases to be executed are submitted to the parameter 
processor in the form of keypunched cards read from the system reader. Each phase is 
identified by a label parameter coded in column 1 of the statement and delimited by a 
statement with the label parameter END coded in column 1. If you omit the label 
parameter for a particular phase of your SYSGEN procedure, that phase will not be 
executed; the system does not provide default capabilities for specifying the parameters 
identifying SYSGEN phases. A few typical coding methods used to identify SYSGEN 
phases are shown in the following examples: 


Example 1: 


Label AOperationA 
SUPGEN 

END 

I/OGEN 

END 


This example illustrates the label parameters required to identify a supervisor 
generation to the parameter processor. The output of this generation § will 
automatically be stored on the OS/3REL volume. 
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@ Example 2: 


Label AOperationA 
SUPGEN 

END 

I/OGEN 

END 

RESGEN 

END 


This example is basically the same as example 1, except that the output of the 


generation is to be written to your designated SYSRES volume as indicated by the 
RESGEN label parameter. 


Example 3: 


Label A OperationA 
SUPGEN 
END 
I /OGEN 
END 
SUPGEN 
@ x 
I /OGEN 
END 


This example illustrates the label parameters and their order of specification to 
configure multiple supervisors for your system. 


Example 4: 


Label A OperationA 
SUPGEN 

END 

I /OGEN 

END 

EMULAT 

END 


This example shows an emulator configuration being included in a single run as part 
of a supervisor generation. 
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Example 5: 


Label AOperationA 


COMMCT 
END 


This example shows an ICAM configuration being submitted as the only phase of 
SYSGEN to be executed. 


Example 6: 


Label AOperationA 
SUPGEN 

END 

I/OGEN 

END 

COBGEN 

END 


This example shows a COBGEN phase being included as part of a single run for a 
supervisor generation. 


1.4.2. Integrating System Software into Your System 


There are basically three different methods that can be used to integrate the software 
provided on the OS/3REL volume into your system. Two of these methods let you 
install new release software to your system and can be used either by new users who 
are installing an operating system for the first time or existing users who are upgrading 
their software to a new release level. The third method is for the user who wants to 
regenerate or tailor his existing software without actually upgrading the level of the 
software. In all cases, the OS/3REL volume must be mounted on a disk drive and be 
online. 


To compare your existing system software to that contained in the new release, we 
suggest that you review the software enhancements contained on the new OS/3REL 
volume delivered to your facility. The system release description (SRD) that accompanies 
your release describes the software contained on the new OS/3REL volume and lists 
the restrictions associated with its use. 


1.4.2.1. Integration for New or Existing Users 


If you are a new user initially installing OS/3, or an existing user who wants to upgrade 
his software to the current release level, two basic methods of software integration are 
available to you. One method allows you to place the SYSGEN output on the OS/3REL 
volume, which then becomes your permanent system resident volume (SYSRES). The 
other method allows you to create a new SYSRES on a separate disk pack. 
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6 In either method, the current OS/3REL volume functions as both operating system and 
source volume for the SYSGEN procedure. 


Placing the SYSGEN output on the OS/3REL volume will give you a SYSRES that << 
contains the entire OS/3 release, plus any tailored supervisors you generated as well as 

other optional software such as separately-priced program products and programming 

aids. 


Creating a new SYSRES volume permits you to individualize your operating system to a 
greater extent; you can delete the system software you don't need, leaving more room 
on your SYSRES volume to place your own library files. Both methods are depicted in 


Figure 1—2. 


RUN PARAMETER PROCESSOR 
(SGSPARAM) AND EXECUTE 
THE FOLLOWING SYSGEN 


IPL SUPERVISOR | PHASES: 


FUNCTIONS 
AS YOUR 
OPERATING 
SYSTEM, 


SYSGEN OUTPUT 


SUPGEN 
1/OGEN 


PLUS OPTIONAL PHASES: 


SOURCE 

VOLUME, AND EMULAT 

é OUTPUT COMMCT 
venir NTRGEN 


COBGEN 


RUN PARAMETER PROCESSOR 
(SG$PARAM) AND EXECUTE 
THE FOLLOWING SYSGEN 
PHASES: 


SUPGEN 
FUNCTIONS IPL 1/OGEN 
AS YOUR SUPERVISOR RESGEN 
OPERATING 
SYSTEM AND 
SOURCE VOLUME 


SYSGEN 
OUTPUT 


ANY USER 
SPECIFIED 
DISK OTHER 
THAN OS$/3REL 
VOLUME 


PLUS OPTIONAL PHASES: 


EMULAT 
COMMCT 
NTRGEN 
COBGEN 





Figure 1-2. System Generation for New or Existing OS/3 Users 


Before you can initiate the SYSGEN procedure, you must load control storage (COS) 
with the microprogramming needed by the hardware to perform its basic functions and 
you must initial program load (IPL) the starter supervisor into main storage. The 
procedures for loading COS and performing the IPL operation are given in the operations 
handbook for operators, UP-8072 (current version). 


¢ You may then call in the parameter processor (SGSPARAM) to translate and validate 
your SYSGEN configuration parameter specifications. If you are generating your system 
from a workstation, you have the option of running SGSPARAM after you see the 
summary listing of your dialog session or of having the system automatically run 


SG$PARAM. 
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In either case, to get a printout from the parameter processor, your system must 
contain a printer that meets the printer characteristics supported by the _ starter 
supervisor. If it does not, you must call in the print buffer processor (SGSPRB) to define 
your print band characteristics to the operating system before you can run job control 
stream SG$PARAM. This procedure is described in 10.6. 


The steps required for performing a SYSGEN are discussed in 1.4.4 and detailed in the 
operating procedures outlined in Section 10. 


1.4.2.2. Regenerating at Same Release Level 


The third method of system software integration is used when you simply want to add 
a new supervisor, emulator, communications module, or COBOL default options to your 
SYSRES volume. In this case, the OS/3REL used to generate your existing SYSRES 
volume must again be available for use as a source volume. This method cannot be 
used with an OS/3REL that is at a higher release level than your SYSRES. 


If the current OS/3REL is your SYSRES volume, it functions as both your operating 
system and source volume (as in Figure 1-2), as well as your output volume. If the 
current OS/SREL is not your SYSRES volume, the OS/3REL serves as your source 
volume only and your SYSRES functions as your operating system and your output 
volume. In either case, simply IPL the supervisor into main storage and call in the 
parameter processor (SG$PARAM) to translate and validate your SYSGEN configuration 
parameter specifications, as illustrated in Figure 1—3. This procedure can also be 
performed in a multijobbing environment. 


IPL 
SUPERVISOR 


FUNCTIONS 


AS YOUR 
OPERATING 
SYSTEM 


RUN PARAMETER PROCESSOR 
(SG$PARAM) AND EXECUTE THE 
FOLLOWING SYSGEN PHASES: 





SYSGEN EXISTING SYSRES 


SUPGEN OUTPUT WITH NEW 


/OGEN SUPERVISOR, 


RESGEN (SYSOUT=vsn,,NOPREP) 


EMULATOR, 
COMMUNICATIONS 
MODULE, OR 
COBOL OPTIONS 


AND/OR 


EMULAT 

COMMCT 

NTRGEN 

SOURCE COBGEN 
DATA 





SERVES AS 


YOUR SOURCE 
VOLUME 





Figure 1-3. Adding Software at Same Release Level 
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1.4.3. Preparing SYSGEN Configuration Parameter Sets 


Once you have determined that a SYSGEN is required, you are responsible for defining 
the specifications for each SYSGEN phase to be executed. This is accomplished by 
entering parameter specifications on cards or at a workstation and submitting them to 
the parameter processor (GGSPARAM). You need only specify those parameters that do 
not meet the requirements of your particular configuration by default. Default values for 
most of the parameters omitted or misstated are automatically assigned and are usually 
sufficient. | 


Part 2 of this manual describes the parameters associated with each phase of SYSGEN. 
You should familiarize yourself with this information before attempting to define 
parameter definitions. The conventions for specifying parameter definitions are piewiged 
in Appendix A. Examples are given in Part 3. 


1.4.4. Initiating the SYSGEN Procedure 


Perhaps the best method of outlining the procedure for performing a SYSGEN operation 
is by summarizing everything that has been discussed in this section. The intent is to go 
through a SYSGEN procedure, considering all of the variables involved and the steps 
needed to achieve the end result. The procedural steps to perform an actual SYSGEN 
are given in Section 10. 


As previously discussed in this section, you must initially determine whether a SYSGEN 
is required, the method that you are going to use to integrate the output of your 
SYSGEN into your system, and the SYSGEN phases of operation that must be executed 
to install, update, or tailor your existing system software. When this is accomplished, 
you are ready to proceed with the SYSGEN procedure. 


1. Prepare your SYSGEN parameter specifications to identify the specific phases of 
SYSGEN to be performed and define the parameters under which those phases 
must be executed to meet the SYSGEN requirements of your configuration. (Take 
advantage of the default capability designed into the SYSGEN software.) | 


2. Initialize your system by: 
= mounting the OS/3REL volume on the proper disk drive and, if applicable, 
mounting your new output disk pack (required if creating a new SYSRES 


volume) and placing each unit in the run state; 


m loading the microcode into the COS (applicable only to initial installation of 
OS/3REL); and 


= loading the initial program records (IPL) and the starter supervisor into main 
storage. 


3. Enter your SYSGEN parameter statements into the system. 
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4. Initialize the SYSGEN procedure, and execute the parameter processor to translate 
and verify the SYSGEN parameter statements. 


The parameter processor reads the statements, verifies them, and prepares an 
output listing on the system printer that contains: 


= @ all the statement images read; 
= all the default specification assignments; 
m™ diagnostics concerning your configuration specifications; and 


m the names and execution sequence of the job control streams that must be run 
to accomplish the SYSGEN procedure you have defined. 


5. Correct any parameters needed to satisfy the diagnostic and warning messages 
displayed on the output listing report prepared by the parameter processor. Rerun 
the parameter processor job as many times as needed to resolve these problem 
areas. 


6. Observe the list of job control stream names to be executed and the sequence in 
which they are to be executed. When you use the SYSGEN dialog at the 
workstation, the names of the job control streams appear on your screen, one at a 
time, aS you complete each successive job stream. 





1.4.5. Running the SYSGEN Job Control Streams 


Run each job control stream in succession, making certain that the first job is completed 
before proceeding to the next. The job control streams may be executed by keying in at 
the system console or at a workstation RUA and the job control stream name. All job 
control streams except SGSPARAM and SGS$PREP may alternatively be run with the 
system command RV instead of RUN. The RV command is preferable in a multijobbing 
environment, because use of the RUN command ties up the card reader for the length of 
time the RUN processor ‘“‘preprocesses’’ the job stream and precludes its use by other 
jobs. 





PART 2. KEYWORD PARAMETER 
SPECIFICATIONS 


e 
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2. Supervisor Generation (SUPGEN) 


2.1. GENERAL 


The parameters used to configure a supervisor for your system are described in this 
section. We recommend that you first read the supervisor user guide, UP-8075 (current 
version) to fully understand the options available to you when generating a Supervisor 
through the use of these keyword parameters. You should be aware that each optional 
feature you select adds to the size of the supervisor you configure; in each case, the 
tradeoff between performance and main storage requirements should be considered. 


Throughout this section, we have estimated main storage requirements for many of the 
specifications, or have given formulas that enable you to make your own estimate. 
These estimates should be used only as guidelines. Since many of the SYSGEN 

© parameters are interdependent, specifying one optional feature may result in increased 
main storage requirements for other functions. 


The statements containing the supervisor configuration parameters immediately follow 
the statement with the SUPGEN parameter coded in the label field. This statement 
signifies the start of the Supervisor section, which is delimited by the statement with 
END coded in the label field. 


Although you may specify any supervisor keyword parameter, you are not required to 
do so to configure a supervisor. If any parameter is omitted or misstated, the default 
value for that parameter is automatically substituted. Misstated parameters cause a 
diagnostic warning code to be generated and displayed on the output listing presented 
at the system printer. 


In cases where a parameter is duplicated, the first definition processed establishes the 
value for that parameter, unless otherwise indicated in the keyword parameter 
description, and a diagnostic warning code is generated on the output listing. 


If you want to generate multiple supervisors, you can submit up to four SUPGEN phases 
to SGSPARAM for processing. Each phase consists of one SUPGEN section immediately 
followed by its associated I/OGEN section. You may not submit the configuration 
parameter statements for more than one SUPGEN section (back-to-back) without having 
the associated I/OGEN configuration parameter statements intervene each SUPGEN 
section. 


A restriction in the use of the SUPGEN keyword parameters is that the SUPMOD 
keyword parameter, if used, must be the first keyword specified in this section. All 
other keyword parameters may be specified in any order desired. 
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To code the SUPGEN keywords when you specify SUPMOD is actually a waste of time 
since SUPMOD tells the parameter processor to ignore all other keyword parameters for 
the SUPGEN section. (See the SUPMOD description for restrictions in its use.) A 
flowchart for the SUPGEN section is illustrated in Figure 2—1. 
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@ If you ever want to delete a supervisor to conserve SYSRES space, you do so using the 
system librarian delete (DEL) and pack (PAC) functions. We describe these functions in 


the system service programs user guide/programmer reference, UP-8062 (current 
version). 


_ When deleting an unwanted supervisor, you must delete it from both the system load 
code library (SY$LOD) and the system source code library (SY$SRC). And when deleting 
the unwanted supervisor from $Y$SRC, you must prefix the name of the unwanted 
supervisor with S$. For example, if the name of your unwanted supervisor is MYSUP1, 


you would specify to the librarian that you want to delete the supervisor module named 
SSMYSUP 1. 


2.2. SUPGEN KEYWORD PARAMETERS 


Format: 
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Keyword Parameter SUPMOD: 


SUPMOD=supvrnam 
Specifies the name of a supervisor configuration that has been defined by a 
previous SYSGEN and saved in the system source library file (GSYSSRC) of your 
SYSRES volume or the OS/3 release volume (OS/3REL). The established 
supervisor may be requested through the use of this parameter. If used, 
SUPMOD must be the first keyword specified in this section. 


When this keyword parameter is submitted, all other SUPGEN parameters with 
the exception of SUPVRNAM are ignored, and a diagnostic message is written 
on the output listing. 
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Keyword Parameter SUPVRNAM: 


SUPVRNAM=supervisor name 
Specifies the name of the supervisor. The name can be a maximum of six 
characters. When used with the SUPMOD parameter, it renames the supervisor 
configuration copied from your existing SYSRES volume. 


Keyword Parameter PRIORITY: 


PRIORITY=1-60 
Establishes the number of task priority levels recognized by the supervisor and 
is used when the system has multijobbing capabilities. 


Keyword Parameter JOBSLOTS: 
JOBSLOTS=1-7 
Specifies the number of concurrent jobs that can be executed in the system. 


The maximum number is seven. 


Each job slot requires four bytes of main storage for each data path, i.e., each 
subchannel configured in your system. Your system may include: 


= A maximum of eight data paths for the multiplexer channel; 

# A maximum of four data paths for the integrated peripheral channel; 
= One data path for the integrated disk adapter; and 

@ One data path for each selector channel. 

NOTE: 


Specifying more than one job slot increases the size of the physical I/O control 
modules, thus forcing configuration of a larger supervisor. 


Keyword Parameter TRANS: 


TRANS=1-15 
Specifies the number of transient areas that should be established in main 
storage. The more transient areas declared, the more jobs requiring transient 
areas can be operating concurrently. Each transient area is allocated 1200 
bytes of main storage whether it is being used or not. For most multijobbing 
applications, between two and four transient areas are sufficient. 


NOTE: 


lf you specify RESMOD=SM$LOD, be sure to specify at least 4 to 6 transient 
areas. 
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Keyword Parameter ERRLOG: 


ERRLOG=NO 
Indicates that an !/O error log is not to be maintained by the supervisor. 


Error logging requires 1K-bytes for its coding plus 280 bytes (minimum) for 
tables and three error log buffers. Space requirements for additional buffers 
can be calculated by using the formula: 

nx 80 


where n is the number of additional error log buffers specified. 


Error logging is not supported in a minimum OS/3_ operating system 
configuration. 


Keyword Parameter ERRLOGBUF: 
ERRLOGBUF=3-2400 
Specifies the number of resident, 80-byte buffers assigned for error logging. 
The keyword is applicable only when error logging is configured into the 
generated supervisor. 


Keyword Parameter TIMER: 


Indicates the extent of timer services to be included in the supervisor. 





MAX (if COMM is specified) 

Specifies time-out capabilities for |1/O devices, with GETIME and SETIME 
macros available. If communications capability is configured, SYSGEN will 
default to TIMER=MAX, even tf another option is specified. Maximum timer 
services require approximately 400 bytes of main storage. 





pecifies time-out capabilities for 1/O devices. If spooling is specified for the 
system, TIMER=MIN is the default specification used instead of TIMER=NO. 
Minimum timer services require approximately 50 bytes of main storage. 





Specifies no timer services are to be maintained. 


TIMER=NORM 
Specifies time-out capabilities for I/O devices, with the GETIME macro 
available. Normal timer services require approximately 200 bytes of main 
storage. 
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Keyword Parameter MAXTYPE: 


es | 


Specifies whether the max-time parameter on the JOB statement defines 
elapsed wall-clock time or job CPU time. 





Keyword Parameter MAXTIME: 


meine als 


Specifies the default time (in minutes) for the maximum time parameter on the 
job statement. To specify MAXTIME you must also specify (not default) 
spooling, JOBACCTREQ=YES, and either TIMER=MAX or TIMER=NORM. 


Keyword Parameter DAYCHANGE: 
DAYCHANGE=NO 
Specifies that the date and time are not to be automatically changed at 
midnight of each day. Automatic day change uses approximately 20 bytes of 
main storage. 


Keyword Parameter SYSTEMDATE: 


Specifies the system date format at IPL time. 





SYSTEMDATE=MDY 
Define mm/dd/yy as the date format. 


SYSTEMDATE=DMY 
Defines dd/mm/yy as the date format. 


Keyword Parameter MEMCONSOL: 


MEMCONSOL=NO 
Indicates that the supervisor is not to consolidate fragmented regions of main 
storage into large, contiguous regions of allocatable main storage. You can 
save approximately 50 bytes of main storage by specifying MEMCONSOL=NO. 


Keyword Parameter SYSDUMP: 


SYSDUMP=NO 
Indicates the resident dump routine is not to be included in the supervisor. 
This routine provides a convenient system program debugging tool in the event 
of a system crash. Specifying SYSDUMP=NO reduces the size of the resident 
Supervisor by approximately 1400 bytes. 
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© Keyword Parameter RESMOD: 


RESMOD=[SMSASCKE][,SM$ATCH][,SM$DBS][,SM$GTPUT][ ,SM$LOCK][,SM$LOD] 
[, SM$STXIT]L,SM$TASK] 
Specifies certain software modules that are to be included in main storage with 
the supervisor rather than transient. You may specify the subparameters in any 
order or in multiple calls of the keyword. 


If, however, you are generating a supervisor for NTR (Section 7), you must 
specify SM$ATCH, SM$LOCK, SM$STXIT, and SM$TASK. 


Subparameters: 


SMSASCKE 
Specifies that the assign key function used by IMS for secondary storage key 
assignment is_ resident. Making this function resident increases IMS 


performance. This option adds approximately 7OO bytes to the resident 
supervisor. 


SMSATCH 
Specifies that ATTACH function processing is resident. It creates and activates 
a task requiring control of the processor. Used mainly for start-up and end task 
processing. Specify this module as resident only if you operate in an unusually 
& heavy multitasking or interactive environment. This option adds approximately 
1200 bytes to the resident supervisor. 


SMSDBS 


Specifies that the data base system (DBS) interface module is resident. This 
option adds approximately 300 bytes to the resident supervisor. 


SMSGTPUT 
Specifies that the GETCOM, PUTCOM, and GETINF functions are resident. Do 
not specify this module as resident unless you know that you have a specific 
processing function that requires it to be resident. This option adds 
approximately 7OO bytes to the resident supervisor. 


SMSLOCK 
Specifies that the supervisor lock and unlock functions are resident. These 
functions provide the read and write file lock capability for lockable files. This 
option adds approximately 900 bytes to the resident supervisor and enhances 
the performance of your supervisor. 


SM$LOD 


Specifies that the module loader is resident rather than transient. Making the 
loader resident decreases loading time. This option adds approximately 3300 
bytes to the resident Supervisor. 


@ NOTE: 


lf you specify RESWMOD=SM$LOD, specify at least 4 to 6 transient areas in 
your supervisor through the TRANS= parameter. 
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SMSSTXIT & 


Specifies that STXIT processing is resident. It creates, changes, or terminates 
linkage between the supervisor and the user island code subroutine. Specify 
this module as resident if you are using the emulator. This option adds 
approximately 1400 bytes to the resident supervisor. 


SMSTASK 
Specifies that the WAIT, TYIELD, CHAP, WAITM, and POST macros are 
resident. These macros help gain efficiency in a multitasking environment. 
SMSTASK is automatically made a resident module if spooling is configured. 
This option adds approximately 1100 bytes to the resident supervisor. 


If the entire keyword parameter is omitted and spooling is not configured, none of 
the referenced modules are made resident. If spooling is configured, the SMSTASK 
module is made resident. If RESMOD=NONE is coded and another subparameter is 
also specified or defaulted, NONE is ignored. 


Keyword Parameter RUNVSN: 


RUNVSN=(8¥SHes 
SYSSPL 


RUNVSN=§¥SRES @ 


e 
s 


Specifies the use of the system resident volume as the RUN device. 








RUNVSN=SYSSPL 
Specifies the use of the first spooling volume as the RUN device (spooling 
must be configured). 


RUNVSN=vsn 
Specifies the serial number of the volume serving as the RUN device. 


Keyword Parameter SCDINDEX: 


SCDINDEX=YES 
Specifies that shared code modules will be loaded faster into main storage and 
faster processing will occur between two or more shared code modules. 
Commonly used shared code modules include the OS/3 general editor (EDT), 
interactive services, screen format services, data management, and ESCORT. 
This feature uses approximately 4000 bytes of main storage. 


Keyword Parameter ONLNDIAG: 


ONLNDIAG=NO 
Indicates that online diagnostics are not to be included. Omitting online 


diagnostics reduces the size of the resident supervisor by approximately 1300 @ 
bytes. 
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Keyword Parameter FLOATPT: 


FLOATPT=YES 
Indicates that floating-point hardware is part of your system. Floating-point 
hardware ts required if you specify FORTRAN during RESGEN (4.2). 


Keyword Parameter COMM: 





Specifies the extent to which your supervisor supports a communication 
capability. lf communications capability is configured, maximum timer services 
are automatically included in your system. 

Positional Subparameters: 


2 
specifies the maximum number of communication adapters (CAs) supported. 


1-24 
Specifies the maximum number of communication lines supported. 


The default value 1 is assigned if either subparameter is omitted or incorrectly 
specified. 


YES 
Specifies that ICAM supports local workstations only. 


lf the entire parameter is omitted, it is assumed that communications is not to be 
Supported by your supervisor configuration. 


Keyword Parameter FILELOCK: 


Specifies the type of file lock system to be generated (described in the data 
management user guide, UP-8068 (current version)). 





files (file-identifier prefixed by $Y$). $LOK and other user designated files will 
not be lockable. 


FILELOCK=YES 


Indicates that the supervisor will maintain file lock capabilities for system files 
(SY$) and user files prefixed with $LOKO1 to $LOK99Q. 


FILELOCK=SHARE 
Indicates that the supervisor will maintain file lock capabilities for all files. This 
includes_user files. without $LOK prefixes as well as system files (S$Y$) and 
user files prefixed with $LOKO1 to S$LOKQ9. 
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Keyword Parameter ROLLOUT: 


ROLLOUT=YES 
Specifies the capability of the supervisor to recognize jobs with preemptive 
priority. The supervisor can then roll lower priority jobs out of main storage for 
higher priority jobs and later roll those lower priority jobs back into main 
storage. lf the ROLLOUT keyword parameter is not specified, the supervisor 
automatically equates the preemptive priority jobs to high priority jobs; thus, 
no rollin or rollout is performed. 


NOTE: 


Specifying FILELOCK=YES or FILELOCK=SHARE may interfere with your system’s 
ROLLOUT capability because jobs with locked OPEN files are ineligible for ROLLOUT. 


Keyword Parameter DLOADBUFR: 


acca 


Specifies the maximum number of 256-byte blocks of main storage that can be 
dynamically allocated (expanded) for a job. We recommend that you specify 
this parameter for use with the ANSI'74 COBOL compiler. If you want your 
COBOL CALL statements to dynamically expand your job’s region, specify the 
maximum value, 32767, unless you know that you must limit the main storage 
expansion by specifying a smaller value. 


Keyword Parameter DLOADT ABLE: 


aia 

1-255 
Specifies the number of entries per job in the job DLOAD table. Choose a value 
equal to the maximum number of COBOL CALL statements in any one of your 
COBOL jobs. For example, if JOBA contains 4 CALL statements and JOBB 


contains 10 CALL statements, specify DLOADTABLE= 10. 
Keyword Parameter TAPEBLKNO: 


TAPEBLKNO=YES 
Indicates that the supervisor supports tapes written with block numbers, as 
well as tapes without block numbers. If omitted, tapes written with block 
numbers are not supported. 


UP-8074 Rev. 11 SPERRY UNIVAC OS/3 2-15 
SYSTEM INSTALLATION 


Se Keyword Parameter SYMBPRI: 


SYMBPRI=/@ 





Specifies the priority level at which system symbionts are to run (including the 
job scheduler, but excluding ICAM). Priority O is reserved for supervisor use 
only. Priorities 1 to 59 may be assigned to user job steps. If omitted, priority 
O Is assigned. 


You can use this keyword parameter to assign the execution priority of system 
symbionts relative to user jobs. For example, specifying SYMBPRI=3 results in 
user job steps at priority 1 and 2 (specified on the EXEC job control 
statement) executing at a higher priority than system symbionts. However, this 
technique should be used only in rare situations for user job steps that are 
extremely time critical. 


Keyword Parameter SPOOLING: 


SPOOL ING=INPUT 
Specifies that both the input readers and output writers are to be used for 
spooling. Data is read from the card reader or diskette to a disk volume and 
then passed to the central processor where it is processed. Any print or punch 
output files generated are sent back to the disk volume and then written out to 


@ the appropriate device. 


Specifies that no spooling capability is to be incorporated in the supervisor 
being generated. 


SPOOL ING=OUTPUT 
Specifies that only the output writers are to be used for spooling. Any print or 
punch output generated from your job is sent to a disk volume and then 
written out to the appropriate device. 


SPOOL ING=REMOTE 
Specifies that remote batch processors, as well as input readers and output 
writers, are to be used for spooling mode. When this keyword parameter is 
specified, the SPOOLICAM keyword parameter must also be specified. 


SPOOL ING=DDP 
Specifies that distributed data processing, remote batch processors, input 
readers, and output writers are used for spooling. if SPOOLING=DDP, also 
specify SPOOLICAM. 
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Main storage requirements for spooling may be estimated as follows: 


m= 4800 bytes for the spooler, whether INPUT, OUTPUT, or REMOTE is specified; 


720 bytes for the system spool control table; 
@ a directory requirement of 
— 72 bytes for OUTPUT, 
— 120 bytes for INPUT, or 
— 168 bytes for REMOTE; 
m 32 bytes for each virtual device configured in the |/OGEN section; and 


m 4 bytes times the number specified by the SPOOLMAP keyword parameter for 
the spool-file bit map. 


In addition, any spooling option requires at least minimum timer services and a 
resident SM$TASK module. 


NOTE: 


If spooling is not configured, all other keyword parameters associated with spooling 
will be ignored. In addition, virtual printers, readers, and punches cannot be 
allocated in the 1/OGEN section. 


Keyword Parameter SPOOLVSN: 


SPOOLVSN=vsn 
Specifies the volume serial number of the primary disk volume that the 
Supervisor is to use as the spool file. If a volume serial number is not 
specified, the primary spool file will be allocated on your SYSRES volume. 


Keyword Parameter SPOOLVSNn: 
Indicates that multivolume spooling is to be supported. Up to eight disk volumes 
may be allocated for spooling. 


“| | 
ce 


vsn 
Identifies the nth sequential volume of the spool file, where n is a decimal 
number from 2 to 8. You may identify each spool volume through multiple 
calls of the keyword (e.g., SPOOLVSN2=vsn, SPOOLVSN3=vsn, etc.), or you 
may denote only the last sequential volume. If you identify only the last 
volume, all other volumes will default to *, permitting you to specify the device 
addresses of the disk units containing the spooling volumes at IPL time. 
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} Keyword Parameter SPOOLCYL: 


SPOOLCYL=(ALL 





SES Soe 


specifies the number of cylinders to be allocated initially for the spool file on 
the primary spooling volume. For most users, the default value of 50 cylinders 
is recommended. If you plan to request more than the default number of virtual 
printers, readers, or punches in the [/OGEN section, you may also require more 
than the default number of spool cylinders. If ALL is specified, all available 
cylinders on the primary spooling volume will be allocated. This option should 
be used only for a dedicated spooling volume. 


Keyword Parameter SPOOLCYLn: 


If multivolume spooling is specified by the keyword parameter SPOOLVSNn, you 
may denote the number of cylinders to be initially allocated on each volume being 
used for the spool file. 


Ss 


Specifies the number of cylinders to be initially allocated for the spool file on 
the nth sequential spooling volume, where n is a decimal number from 2 to 8. 
& If omitted, 50 cylinders will be allocated on each spooling volume. 


Keyword Parameter SPOOLMAP: 






—4 lad 

Indicates the number of full words (four bytes) of main storage to be reserved 
for the resident spool-file bit map. The bit map controls the suballocation of 
the spool file in units called logical tracks, each bit-map word representing 32 
logical tracks. A logical track is at least forty 256-byte sectors long but its size 
can vary, depending on the size of the spool file and the number of bit-map 
words provided. For optimum performance, the number of bit-map words 
specified should allow the spool file to be divided into logical tracks 40 sectors 
in length. 


The number of words required for the spool-file bit map depends on the 
cylinder capacity of the disk volume or volumes being used for the spool file. 
The default size of 64 words allows a spool file of 250 cylinders on 8416 or 
8418 disks to be divided into 40-sector segments, or an entire 8414 disk 
(200 cylinders) to be divided in 40-sector segments. To calculate the optimum 
number of bit-map words, divide the number of cylinders reserved for the 
spool file by the factor indicated in Table 2—1 for the disk type being used. If 
the result is fractional, round to the next higher integer. The number of bit-map 

@ words required to optimize a spool file of 50 cylinders (the default value for 

| the SPOOLCYL keyword parameter) for each disk type is indicated in the third 
column. 
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Table 2—1. Spool-File Bit Map Calculation 


wend Bit-Map Words Needed for 
Eueh Type 50-Cylinder Spool File 
11 





Keyword Parameter SPOOLBUFR: 


SPOOLBUFR=/ 1 






Indicates the size of the spooler work buffer allocated to each job preamble in 
terms of the number of 256-byte blocks of main storage. The only acceptable 
parameters are those shown in the format. 


Keyword Parameter SPOOLOWBUFR: 


SPOOLOWBUFR=/2 


weenie et 


32 
Specifies the number of 256-byte blocks of main storage allocated to the 
spool buffers for the print and punch output writer. Specifying the larger values 
for this keyword parameter increases system performance by reducing the 
number of disk accesses to the spool file. The only acceptable parameters are 
those shown in the format. 


Keyword Parameter SPOOLBURST: 


SPOOLBURST=YES 

Indicates that output spooling is to function in the burst mode of operation. 
Operating in the burst mode requires that an output processing criterion be 
configured to control the output writer's mode of processing for available 
output subfiles. Operating in the burst mode enables the output files to be 
written before the job they are associated with is terminated, depending upon 
the criterion selected. Operating in the nonburst mode implies that output 
subfile processing by the output writers is not done until job termination. 
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& Keyword Parameter SPOOLCOMP: 


SPOOL COMP=NO 
Specifies that the output image in the spool file is not to be compressed. 


If omitted, the output image of the spool file is compressed if three or more 
consecutive blanks are present. 


SPOOLCOMP=NO is not to be specified when: 

— Most of the files created contain a large amount of blanks 

~— Most of the files created use block sizes greater than 120 
Keyword Parameter SPOOLFARSI: 


SPOOLFARSI=YES 
Specifies that FARSI (lranian language) translation is to be executed for all 
spool files containing *FARS! or @FARSI as the first six characters of the 
// LBL job control statement. (To accommodate this capability, the output 
writer is loaded with an additional 40016 bytes of main storage space and the 
input reader is loaded with an additional 30016 bytes of main storage space.) 


e Keyword Parameter SPOOLMODE: 


Establishes an output file processing criterion for the spooler when operating in the 
burst mode. This keyword parameter allows configuration of output spooling to 
efficiently handle all the printed and punched output associated with your job. 
Output files are processed only when the criterion has been satisfied, thus giving 
you more control over all throughput. If operating in the burst mode and no 
criterion is specified, SPOOLMODE=PRI is assumed. Here, output is governed under 
a job priority basis (that is, preemptive, high, and normal priorities). 


When selecting a parameter at SYSGEN time, you are establishing a priority for 
processing all of the available output files in the spool file. If you are uncertain at 
this time as to the criterion to be implemented, you can establish or change the 
specification from the system console at a later time. The procedure is explained in 
the handbook for operators, UP-8072 (current version). 


Establishes the criteria for determining which spool files are processed by the 
output writer when operating in burst mode. The first positional subparameter in 
this keyword specifies the category used by the output writer to select the output 
file to be processed. The output writer uses the value specified in the second 
positional subparameter to locate the file to be processed. (Files that do not have a 
criterion value remain unprocessed in the spool file.) If you omit the second 
subparameter, the output is grouped by criteria category. 
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The criteria values for SPOOLMODE can be changed at any time from the system 
console as described in the handbook for operators, UP-8072 (current version). 


The default specification for the SPOOLMODE keyword’ parameter is 
SPOOLMODE=PRI,O; where the output is processed according to job scheduling 
priorities with files from the higher priority jobs being processed first. 


SPOOLMODE=ACCTNO, account -number 
One to four alphanumeric characters indicating to the output writer that an 
account number is the criterion used for determining file processing. All 
subfiles created by jobs whose account number is the same as the criterion 
configured (as specified on the JOB control statement) are processed without 
operator intervention. 


SPOOLMODE=CARTNAME, cartr idge-name 
One to eight alphanumeric characters indicating to the output writer that the 
cartridge name is the criterion used for determining file processing. All subfiles 
whose cartridge name is the same as the criterion configured (as specified on 
the LCB job control statement) are processed without operator intervention. 


SPOOLMODE=DEVICE,device-type-code 
Specifies the device type code as 0768, 0770, 0773, 0776, 0778, or 9300. 
Indicates to the output writer that the device type number is the criterion used 
for determining file processing. All the subfiles available for processing, whose 
device type is the same as the criterion configured, are processed without 
operator intervention. 


SPOOLMODE=FILE, filename 
One to eight alphanumeric characters indicating to the output writer that a 
filename is the criterion used for determining file processing. All the subfiles 
available for processing, whose filename is the same as the _ criterion 
configured, are processed without operator intervention. 


SPOOLMODE=FORM, form-name 
One to eight alphanumeric characters indicating to the output writer that the 
form-name is the criterion used for determining file processing. All subfiles 
whose form name is the same as the criterion configured (as specified on the 
VFB or SPL job control statements) are processed without operator 
intervention. 


SPOOLMODE=JOB, jobname 
One to eight alphanumeric characters indicating to the output writer that the 
jobname is the criterion used for determining file processing. All subfiles whose 
jobname is the same as the criterion configured (as specified on the JOB 
control statement) are processed without operator intervention. 


© 


UP-8074 Rev. 11 SPERRY UNIVAC OS/3 2-21 
SYSTEM INSTALLATION 


& Keyword Parameter SPOOLICAM: 


SPOOLICAM=(€1 





C? 

Indicates the name of the ICAM symbiont load module (C1—C9 and M1—MgQ) 
that is called by the spooler to service remote batch and distributed data 
processing spooling. If you specify SPOOLICAM=C?, your console operator 
receives a query at run time asking which ICAM symbiont to load. The 
keyword parameter SPOOLING=REMOTE or SPOOLING=DDP must have been 
specified, you must have configured the ICAM symbiont as described in the 
COMMCT section (Section 6), and you must specify a value for COMM during 
SUPGEN. If you omit this parameter, jobs creating output for remote batch or 
distributed data processing will encounter an error at the end of job and will 
require ICAM to be manually loaded in order to process the output. 


Keyword Parameter SPOOLHDR: 


SPOOLHDR=NO 
Indicates that spooled output files are to be printed without headers. lf 
omitted, a 3-page header will precede the printing of each spooled file. 


@ Keyword Parameter SPOOLNOINPUT: 


SPOOLNOINPUT=YES 
Specifies that your supervisor suppresses input spooling for remote batch 
processing and distributed data processing. If you specify SPOOLNOINPUT, you 
cannot use the input reader. 


Specify this parameter when you_ specify SPOOLING=REMOTE or 
SPOOLING=DDP and you want to suppress the INPUT SPOOLING capability 
throughout your SPOOLING system. 


Keyword Parameter SPOOLPRT: 
Specifies the log printing criteria for terminated jobs; includes log types for printing 
(L and A) and whether to print log records. Must specify JOBACCT=YES to have 


A records. 


SPOOLPRT=ACT 
Specifies that job accounting records are to be printed when a job terminates. 





job terminates. 


& SPOOLPRT=LOG 
Specifies that only log records are to be printed when a job terminates. 
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SPOOLPRT=NO 
Specifies that job log and accounting records are not to be printed. 


Keyword Parameter SPOOLRECV: 


Specifies the level of recovery wanted for the spool file when it is necessary to 
reinitialize the supervisor. 


SPOOLRECV=ALL 
Indicates that all spooled subfiles are to be recovered, whether complete or 
incomplete (warm restart). 


SPOOLRECV=CLOSED 
Indicates that only completed spooled subfiles are to be recovered (warm 
Start). 


SPOOLRECV=LOG 
Indicates that only log files are to be recovered (warm start). 





SPOOLRECV=NONE 
Indicates that the spool file is not to be recovered (cold start). 


Keyword Parameter SPOOLTEST: 


The output writer can print a test lines page for each new form. This is a printout 
of the first page of output with all numerics converted to 9's and all alphabetics 
converted to Z's. When the output writer detects a change in form name, a 
message is displayed on the system console asking the operator if a test lines page 
is to be printed. 


SPOOLTEST=NO 
Indicates that the output writer will not display the message asking the 
operator if a test lines page is printed. 


lf omitted, the test lines message will be displayed on the system console. 
Keyword Parameter SPOOLUPDATE: 


SPOOLUPDATE=NO 
Specifies that the spooler updates the subdirectory entry only when a program 


file closes. Should a program cancel, you lose any output that the program 
generated prior to cancellation. 


If you omit this parameter, the spooler updates the subdirectory entry each 
time it crosses a logical track in a program file. Should a program cancel, you 


will be able to print any output that the program generated prior to 
cancellation. 
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& Keyword Parameter DDPSPOOL: 


DDPSPOOL=1-128 
Specifies the number of concurrently running tasks that can return spoolout of 
distributed data processing (DDP) jobs. Each task that can return DDP spoolout 
takes a task control block and at least 8K of dynamic buffer space. 


In most cases, the default value of 10 tasks is sufficient. If, however, your 
system takes too much time to return the DDP spoolout, raise the value. On 
the other hand, if the default value of 10 tasks degrades your system's overall 
performance, lower the value. 


Keyword Parameter JOBACCT: 


JOBACCT=YES 
Indicates that the resident job accounting routines maintain a record of CPU 
time used by job and job step facilities, number of 1/O requests made per 
device, number of supervisor requests generated, main storage usage, and 
transient function usage. This option may be specified only if spooling is 
configured. Job accounting requires approximately 350 bytes in the resident 
supervisor in addition to 100 bytes in each job prologue. 


Keyword Parameter SYSLOG: 


@ SYSLOG=YES 


Provides for accumulation of job and workstation log files (L, A, and W) 
accounting records in the spool file for future transfer to a user disk or tape 
file. If this capability is not configured at SYSGEN time, it can be requested by 
the operator from the system console later. The procedure is explained in the 
handbook for operators, UP-8072 (current version). You must specify 
JOBACCT=YES to have A records. 


Keyword Parameter CONSOLOG: 


Indicates whether console log (C records) and workstation log (W records) are 
collected. Also specifies the size of the main storage buffer area for storing them. 
The system collects a record of all communication between system and console 
(console log) and system and workstation (workstation log) in this buffer, then 
copies it into the spool file when it fills the buffer area. 


CONSOLOG=({ MAX 





NORM 
Indicates the size of the buffer area assigned to accumulate system console 
and workstation messages. MIN specifies a 304-byte buffer; NORM specifies a 
560—byte buffer; MAX specifies a 1072—byte buffer. If omitted or if NO is 
r specified, the console and workstation log will not be recorded in the spool 
file. 
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Keyword Parameter CONPRINT: 


CONPRINT=NO 
Specifies that the console log (C records) is not to be printed when a file is 
breakpointed. 


Keyword Parameter RET AINLOG: 


RETAINLOG=YES 
Specifies that the console log (C records) is to be retained in the spool file 
after printing. 


Keyword Parameter SAM: 


SAM=YES 
Specifies that the system activity monitor dynamically links itself with your 
supervisor when you load the monitor. This monitor generates a record of your 
system's performance. The system activity monitor user guide/programmer 
reference, UP-8812 (current version), gives detailed information on how to use 
this record. 


NOTE: 


SAM collects device statistics for both [/O and DSK classes according to the 
device's position in I/OGEN. It does not collect statistics for anymore than 72 
devices. Therefore, be sure that the real devices which you intend to have 
SAM monitor are the first 72 listed in your I/OGEN. 


Keyword Parameter JOBQUEREC: 


JOBQUEREC=YES 
Indicates that at IPL, your system recovers ail jobs that were scheduled and 
queued when it shut down. 


JOBQUEREC=HOLD 
Indicates that at IPL, your system recovers and holds all queued jobs until you 
are ready to run them. 


Keyword Parameter JOBACCTREQ: 


JOBACCTREQ=YES 
Specifies that a job must have an account number. The account number can be 
supplied either as the eighth positional parameter on the JOB statement, or by 
inserting the OPTION ACCN statement in the job control stream. If this feature 
is specified and an account number is not provided, the job is aborted. 


Keyword Parameter VOLTABLE: 


VOLTABLE=YES 
Specifies that the system's volume table is resident in main storage. This 
feature allows faster allocation and scheduling of volumes during job and 
command processing. Uses 512 bytes of main storage. 


© 
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& Keyword Parameter IGNORESFT: 





Species that the system processes all // SFT statements and loads the data 
management modules that these statements identify before the job is 
scheduled. 


IGNORESFT=YES 
Specifies that the system ignores all // SFT statements and loads the data 
management modules that these statements identify as the job needs them 
during execution. This option allows you to use dynamic shared code without 
having to delete // SFT statements from all of your control streams. 


Keyword Parameter RESHARE: 


RESHARE= {mod-name 
Saas 
Specifies a list of shared load module names or shared load module group 
names that you want resident in main storage. Option helps avoid fragmenting 
main storage space when modules are used frequently. lf you want to specify 
individual module names, execute the SCLIST job stream by keying in 
RVASCLIST. This job then lists all module names eligible for RESHARE. If you 
want to specify shared load module group names, use the groue name 
@ symbols from Table 2-2. 


To decide which modules to make resident for your applications, use the 
operator command, MI SC, to list all modules currently residing in main 
storage. Use MI SC several times to find which modules most frequently are 
resident for your applications. (Or, analyze system dumps.) 


If you ever need to change your RESHARE specification, you can do so each 
time you IPL this supervisor. See the operations handbook for operators, 
UP-8072 (current version) for this procedure. 


Table 2-2. Shared Load Module Groups 


BASIC 

Local Distributed Data Processing 
Remote Distributed Data Processing 
Dialog Processor 

Editor 


ESCORT 
ESCORT Full 


Basic Interactive Services 

Full Interactive Services (for heavy interactive users who experience main storage 
fragmentation) 

RPG Editor 


@ Screen Format Services 
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Keyword Parameter RECOVERDS: 


RECOVERDS=YES 
Specifies that you have the option of either recovering disk space to retry a 
job or of terminating that job when the job step processor displays a warning 
that it cannot allocate sufficient disk space for a job. 


Keyword Parameter INTERACTIVE: 


INTERACTIVE=YES 
Indicates that your supervisor recognizes input from either a workstation or a 
communications terminal that supports interactivity. If your communications 
network supports interactivity, you must specify remote workstation 
parameters in |/OGEN (3.3.8). 


NOTE: 
lf you do not configure interactivity, all other keyword parameters associated 
with interactivity will be ignored. The defaults shown for these parameters 


apply only if you specify INTERACTIVE=YES, unless otherwise shown. 


Keyword Parameter DMGTMODE: 





Ite (if interactivity is not configured) 
Indicates that your system uses only define-the-file (DTF) mode of data 
management. Interactive systems can use DTF mode only if SAT (disk, tape, 
or unit record processor) files are used. 


DMGTMODE=CDI 
Indicates that your system uses only common data interfaces (CDI) to data 
management. CDI data management can access only SAT or MIRAM files and 
provides enhanced file sharing and file lock capabilities. 
DMGTMODE=8exe8 (if interactivity is configured) 
Indicates that your system operates in a mixed data management mode in 
which your programs may be written for execution in either CDi or DTF mode. 
MIXED data management can access all file types. 





NOTE: 


lf you configure interactivity, you must specify either a CDI or MIXED mode of 
data Management. 
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Keyword Parameter DYNBUFMGT: 





NOKE (if interactivity is not configured) 
Indicates that your system does not support dynamic buffer management. 





BASic (if interactivity is configured) 
nciaiacn that your system allocates main storage buffer space dynamically, or 
as your job needs it. Your system must have dynamic buffer management to 
use the spooling option to redirect output files temporarily to disk. 


NOTE: 


lf you specify CDI or MIXED data management, your system defaults to BASIC 
dynamic buffer management. 


Keyword Parameter SHAREDMGT: 


SHAREDMGT=(8 (if DTF mode in noninteractive environment) 

46 (if CDI mode in noninteractive environment) 
4@ (if CDI mode in interactive environment) 
1- 16384 
Specifies the total number of 24-byte slots to be reserved in a resident table 
that controls shared data management modules. Each shared module in main 
storage at a given time requires one table entry. For most multiobbing 
applications, the default values provided for each mode and environment are 
sufficient. If you need additional slots in an unusually heavy multijobbing 
system, you should specify a value above that of the default value. If you need 
fewer slots in a system with less than three job slots, you should decrease the 
value. 





Keyword Parameter EXPREGION: 


EXPREGION=0-999999 
Specifies the size in bytes of your system’s expansion regions within main 
storage from which your system dynamically allocates (expands) buffers to 
your job. If your system has more than four workstations in an unusually heavy 
interactive environment, increasing your expansion region size may help to 
reduce main storage fragmentation. As a minimum, you should specify the 
default size of 4096 bytes. 


lf you ever need to change the value that you specify now, you can do so 
each time you IPL this supervisor. See the operations handbook for operators, 
UP-8072 (current version), for the procedure. 
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a 





Keyword Parameter RESBUFSIZE: & 


RESBUFSIZE=1-999999 

Specifies the size in bytes of the resident buffer pool within the supervisor 
from which your system dynamically allocates buffers. If you specified a size 
equal to or greater than the 4096-byte default value for EXPREGION, the 
default size of 500 for RESBUFSIZE is probably sufficient for all systems using 
workstations. If you are a moderate to heavy workstation user, you may be 
able to improve system performance by specifying a large RESBUFSIZE value. 
For example: 100,000; then, raise or lower that size depending on your 
experience. 


lf you operate in a batch environment, you may want to specify a size less 
than the default value. 


lf you ever need to change the value that you specify now, you can do so 
each time you IPL this supervisor. See the operations handbook for operators, 
UP-8072 (current version), for the procedure. 


Keyword Parameter TRNWKAREA: 


TRNWKAREA=YES 
Specifies that your system generates a 65K transient work area to keep the 
most recently used transient modules in main storage. If specified, transients ®& 
can be loaded into main storage directly from the work area instead of from 
your SYSRES volume. This reduces the number of !/O delays that occur and 
thus improves performance. 


If you ever need to change your TRNWKAREA specification, you can do so by 
issuing the TW command after you perform an initial program load (IPL). See 


the current version of the operations handbook, UP-8072, for the procedure 
for issuing the TW command. 


Keyword Parameter ISINTLMT: 


ISINTLMT=1-255 


Specifies the maximum number of interactive users that your system 


recognizes at any one time. Interactive sessions use only workstation or 
interactive Communications terminal input. 


Keyword Parameter ISBATCHLMT: 


ISBATCHLMT=1-255 


Specifies the maximum number of batch sessions that can execute concurrently 
in your system. Batch sessions use only card image, tape, or disk input. 


Keyword Parameter ISINTPRI: 


ISINTPRI=§-60 7 


Specifies the priority level of interactive commands entered from either a 
workstation or an interactive terminal. 
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©& Keyword Parameter ISKEYS: 


ISKEYS=YES | 
Indicates that your supervisor limits interactive services to using only its own 
space in main storage. Protecting interactive services uses a job slot, therefore, 
reduces the maximum number of concurrent user jobs to six. 


Keyword Parameter ISADMID: 


ISADMID=administrator id 
Specifies a 1- to 6-character id that identifies your system's security 
administrator. Your security administrator is the only user who can add or 
delete other user ids from your security file. The first character of administrator 
id must be an alpha character: the remaining five must be alphanumeric. If you 
don't specify this parameter id, the system defaults to no id and you will not 
have a system security administrator. 


NOTE: 


To use security maintenance utility (SMU), specify this parameter. 


Keyword Parameter ISLOGONSC: 


ISLOGONSC=YES 
@ Indicates that your system checks its security file when a user logs on. If you 
specify ISLOGONSC=YES, the user's identification must be a valid name in 
your security file. If ISLOGONSC=NO, any user can log on to your system with 
any identification. 


NOTE: 


To use security maintenance utility (SMU), specify YES. 
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3. Input/Output Device 
Configuration (I/OGEN) 


3.1. GENERAL 


The I/OGEN configuration specifications defined in this section allow you to relate the 
peripheral device configuration of your system to your particular supervisor. If you have 
specified the generation of multiple supervisor configurations in the SUPGEN section, 
you must also prepare individual |/OGEN sections for each of those supervisor 
configurations. Each |/OGEN section must immediately follow its associated SUPGEN 
section when it is submitted for processing. 


The I/OGEN configuration specifications are presented in the form of label parameters 

© and keyword parameters keypunched onto cards or keyed in at a workstation and 
submitted immediately following the statement containing the |/OGEN parameter coded 
in the label field. The |/OGEN parameter signifies the start of the |/OGEN section, which 
is delimited by the statement with END coded in the label field. The label parameters 
identify a device category (PRINTER, READER, PUNCH, DISC, TAPE, WORKSTATION, 
REMWORKSTATION, and REMPRINTER), and the keyword parameters define the 
particular specifications for that category (e.g., ADDR, TYPE). 


There are various options available when you select the method of specifying the 
parameters for your |/O configuration. For example, if your existing SYSRES volume 
contains an |/O configuration that was defined for a previously generated supervisor, 
and it meets your present I/O configuration requirements, you may request this I/O 
configuration through the |/OMOD keyword parameter by naming the supervisor for 
which it applies. 


In cases where the default values for the keyword parameters of a particular device 
category are identical to your |/O requirements, you need only specify the label 
parameters for the device category. The default values for that device category will be 
automatically generated for you. If, however, you need to modify some of the 
specifications for a particular device, you must specify both the label parameter for the 
device and those keyword parameters requiring change. 


You should also be aware that although the keyword parameters have default values 
assigned to them in case they are omitted or misstated, the label parameters for device 

@ categories do not have default values. Therefore, if you omit a label parameter, the 
supervisor is generated with no I/O configuration for that device category. 
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The label parameter for a given device category must be repeated whenever that 
category contains (specifies) more than one type of device. For example, if you have 
two types of disks (SPERRY UNIVAC 8418 and 8430), you must specify two DISC label 
parameters and, therefore, two DISC device categories. 


It is not necessary, however, to repeat the label parameter specification when you want 
to relate more than one device (of the same type) in a category to the supervisor being 
generated. You simply identify these additional devices by specifying their respective 
addresses. 


We recommend that you define each |/O device in order of most frequent use. This will 
reduce |/O access time during later processing. You need not define all devices for the 
same category consecutively (even if they are the same type). For example, you may 
define the disk device containing your SYSRES volume first, followed by printers, 
readers, tapes, other disk devices, punches, and workstations. 


As previously stated, keyword parameters that are misstated have default values 
assigned to them; however, a diagnostic message is generated and written into the 
output listing. Illegal keyword parameters for a device category are ignored, and a 
diagnostic warning is also written into the output listing. 


A flowchart for the 1/OGEN section is illustrated in Figure 3—1. This figure presents the 
system devices and the options that are available for those devices; it also presents the 
common parameters that pertain to all system devices and the parameter that pertains 
to the system console printer (COP). 


When deleting an unwanted 1|/O configuration module, you must delete the module in 
the same way we discussed for deleting unwanted supervisor modules. (See 2.1.) 
Similar to supervisor deletion, when deleting the I/O configuration module for an 
unwanted supervisor from $Y$SRC, you must prefix the name of the unwanted 
supervisor with I$. For example, if you wanted to delete the I/O configuration module 
for a supervisor named MYSUP1, you would specify to the librarian that you want to 
delete the 1/O module named ISMYSUP1. , 
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Format: 


LABEL AOPERATIONA 
I/OGEN 
PRINTER 
[I /OMOD=supvrnam] 


CHAN=( channel 
@ (for 0773/0778) 


pas 
OP 
—_ 
DDR= 
ig 
ne "a" 
= ; 
B Ss 
bens 5 i 
ratets > oo = 
rakes raf “ 
ee 
Be Sa 










0773/0778) 
9200/9300) 
0770/0776) 
0768) 


28 (for 0773/0778/9200/9300) 
e (for 0768/0770) 


© (for 0776) 


eames PROC ONS 


66-8US (for 0770/0773/0776/0778) 


9200/9300) 


PRINTER 





(continued) 
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AOPERATIONA 
I/OGEN 
(cont) 


READER CHAN=( channel 


® (for 0717) 
4 (for 0716/0920/0930/2703/9200/9300) 


ADDR= eae. 








0717) 
0716) 
2703) 
0920/0930) 
9200/9300) 


(NUK only) 


[DVCNO=Lun] 


FEED=/51 
66 
- 


* TRAN= { NO 


VALIDITY= K bons 


persracs |= 


ee ASCII 


o 










; 


eee. 


Poooood 


1-99 
[PUNCH] CHAN=(channel 


@ (for 0605) 
I (for 0604/0920/0930/9200/9300) 
ADDR=/address 









@5 9605) 
(for 0920/0930) 
(for 9200/9300) 


5S® (for 0604 ; 
ier (continued) 
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SYSTEM INSTALLATION Update B 
LABEL AOPERATIONA © 
I /OGEN 
(cont) 
(NUK only) 
[DVCNO=Lun] 
hae 
haa {we (for aaa 
WES (for 0605) 
j TACKSEL= NO } 
aa E= {we 
PUNCH VIRTUAL =(40@ 
[DISC] CHAN=(channel 
3 (for 8415/8416/8418/8430M/8433M) 
% (for 8411/8414/8424/8425/8430/8433) @ 


a 


ADDR=( address 
@6 8% (for 8415/8416/8418/8430/8433 /8430M/8433M) 
(for 8411) 
SEE ctor 8414/8424/8425) 







Bota OSS aad 


[COADDR=address] 


—. 2-64 

5 em | 
TYPE=/ 8411 

8414 

oe)? 








8430M (NUK only) 
8433M (NUK only) 


Y (OVeNO<tuin} 


° - _ | @ 


A (continued) 
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AOPERATIONA 


CHAN={channel 
(@ (for 8413) 
[AopR=f{ address 
eawett (for 8413) 
[TYPE=B#43] 
[DVCNO=Lun] 
















[DISKETTE] 
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LABEL AOPERATIONA 





[TAPE] CHAN=[{channel 
4 (for 6/10) 
4 (for 12/14/16/2@) 


mt! 
| 


[COADDR=address] 


TYPE=/6 
10 
14 
16 
20 


[DVCNO=Lun] 





















MODE={nn 
€8 (for 10/12/14/16/20) 
y 


RANSLAT= { NO: 


DENSITY=( BUAL (for 10/12/14/16) 
NRZI (for 6) 





: v= 
] 


[WORKSTATION] hones 





[DVCNO=Llun] 


oid NO 


— (- 








[REMWORKSTATION 








[SCRENMEM={ 1- 


belie ANA= es 
YES 


[REMPRINTER AMOUNT= {4-99} ] 
@ ico: 
[END] 
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3.2. REQUESTING A PREVIOUSLY CREATED I/O CONFIGURATION 


We have included in the |/OGEN phase of system generation the capability that allows 
you to relate, to the new supervisor being generated, the I/O configuration defined for a 
previously generated supervisor. This established |/O configuration resides in the system 
source library file (SY$SRC) of your SYSRES volume and the OS/3 release volume 
(OS/3REL). The convenience of this feature is that you don’t need to redefine or 
process |/O specifications for the new supervisor, especially when your system 
configuration has not changed. Your responsibility is to include the |/OGEN section and 
to specify the |/OMOD keyword parameter. 


Keyword Parameter !/OMOD: 


I /OMOD=supvrnam 

Specifies the name of a supervisor for which an I/O configuration previously 
has been created and saved in the system source library file of your SYSRES 
volume or the OS/3 release volume. You may request this established |/O 
configuration by specifying the |/OMOD keyword parameter as the only 
parameter immediately following the statement with the |/OGEN parameter in 
the label field. No other |/OGEN parameters are required. If other |/OGEN 
parameters are used with the |/OGEN parameter, they are ignored and an 
appropriate diagnostic message is written on the output listing. 


3.3. CREATING A NEW 1/0 CONFIGURATION 


The keyword parameters that define the I/O configuration related to your supervisor are 
described in 3.3.1 through 3.4. Four keyword parameters are common to each of the 
device categories defined in an I/OGEN operation. These common parameters are 
CHAN, ADDR, TYPE, and DVCNO. Instead of repeating their definitions in each device 
category listed, they are described collectively under the heading: Common Keyword 
Parameters (3.3.1). Those keywords applicable to a specific device are presented and 
defined under the name for that category of device. 


Many of the parameters have default specifications that are device dependent. That is, 
the default specification selected by the operating system is based upon the device type 
(in each device category) specified, or defaulted to, by the TYPE keyword parameter. 
When this situation occurs, the applicable default specification is identified by enclosing 
its related device type in parentheses immediately following the specifications presented 
in the |/OGEN format. 


3.3.1. Common Keyword Parameters 


Keyword Parameter CHAN: 


Identifies the physical |/O channels that have access to the device or group of 
devices being described. 


CHAN=0 
Identifies the integrated peripheral channel. 
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© CHAN=1 


Identifies the multiplexer channel. 


CHAN=3 
Identifies the integrated disk adapter. 


CHAN=4 
Identifies selector channel 1. 


CHAN=6 
Identifies selector channel 2. 


The default specifications for this parameter are device dependent and are 
determined as a function of the TYPE keyword parameter specification presented 
for each device category. (See I/OGEN format.) 


Keyword Parameter ADDR: 


Identifies the hardware address of the device or group of devices being described, 
as well as the number of devices. The address must be a 2-digit hexadecimal 
number. If more than one address is being identified, the addresses must be 
separated by commas, or a hyphen may be used to indicate consecutive addresses. 


ADDR=/address 
© @2 (for 0773/0778) 


9200/9300) 
0770/0776) 
0768) 





Specifies the printer. 


ADDR=/address 
@¢ (for 0717) 
(for 0716) 
(for 2703) 
(for 0920/0930) 
(for 9200/9300) 







Specifies the reader. 


ADDR=/ address 
(for 0920/0930) 
(for 9200/9300) 


(for 0604) 





Specifies the punch. 
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ADDR=(address 
hi 6 @t (for 8415/8416/8418/8430/8433 /8430M/8433M) 





ae 


Specifies the disk. 


For the 8415, the device address for the fixed portion is an even number, while the 
device address for the removable portion is the next higher odd number. The 
default address is OO for the fixed portion of the 8415 disk and O01 for the 
removable portion. 


lf you specify TYPE=8415, you can default to device address OO and 01, or you 
can enter ADDR=00,01 or ADDR=02,03 or ADDR=OO-03. 


NOTE: 


For each type of disk attached to the selector channel, you must specify at 
least one address ending with zero. 


Sateteinletorete‘erete.ora‘ele'et<Patetorsty 


4®.1% (for 8413) 





is font 


Specifies the diskette. 


ADDR=/address 
weer (for 6/10) 
(for 20) 


$8,57 (for 12/14/16) 








Specifies the tape. 


ee ee | 


mh ee a 4 x 
BS: 2 Ses Sy i 


Becuden Cnet as 


Specifies the workstation. 
Keyword Parameter TYPE: 


TYPE=device number 
Identifies the type of device or group of devices being described. The device 


number must be one of the numbers shown in the format identifying the 
printer, reader, punch, disk, diskette, tape devices, or workstations. 
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@ Keyword Parameter DVCNO: 


DVCNO=Lun 
Changes the standard logical unit numbers for the specific devices within each 
device category. You may modify or replace the logical unit numbers for the 
device or group of devices by specifying the logical unit numbers in decimal. If 
two or more logical unit numbers are specified, they must be separated by 
commas. If consecutive numbers are specified, they must be separated by a 
hyphen. It is recommended that you do not alter logical unit numbers outside a 
device category or alter the logical unit numbers assigned to the “‘any”’ device. 


Table 3—1 shows the logical unit numbers and their corresponding device types. 


Keyword Parameter AT TNRE: 


ATTNRE=YES 
Indicates that the retry on attention interrupts feature is desired. This will 
permit automatic retry of a recoverable error when an attention interrupt is 
received on a printer, card reader, or punch card that has an unanswered 
physical lOCS error message. Instead of having to respond to the console error 
message with an R, the operator can initiate the recovery retry at the device 
by placing it in the online mode. This feature is available only for printers, card 


readers, and card punches; however, it does not apply to these devices on the 
9200/9300. 


Table 3-7. Logical Unit Numbers (Part 1 of 2) 


Reader of 0920/0930 paper tape subsystem 





| 3, 4 Punch of 0920/0930 paper tape subsystem 















2703 optical document reader 


7 Online 9200/9300 printer 
Online 9200/9300 card reader 


9 Online 9200/9300 card punch 

10-17 Spare 

18, 19 Reserved 

20, 21 Any printer, no features specified 

22, 23 0773/0778 printer subsystem, no optional features 
24, 25 0776 printer subsystem, no optional features 

26, 27 0768 printer subsystem, no optional features 

28" ,.2Z29° 0770 printer subsystem, no optional features 

30, 31 Any card reader subsystem, no features specified 


0717 card reader subsystem, no features specified 
0716 card reader subsystem, no features specified 


Reserved 





Any card punch subsystem, no features specified 
0605 card punch subsystem, no features specified 
0604 card punch subsystem, no features specified 


* Device type code changed to that for 0776 during supervisor initialization, if 0776 
printer ts used in place of 0770. 
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Table 3-1. Logical Unit Numbers (Part 2 of 2) 


Logical Device Type and Features 
Unit No. 


46, 47 
48, 49 


50-59 
60-63 
64-66 
67-69 
70-74 
75~—79 
80-85 
86-89 


90-99 

100-102 
103-105 
106-109 


110-112 
113-115 
116-119 
120-122 
123-125 
126, 127 
128, 129 
130-133 
134, 135 
136, 137 
138, 139 
140, 141 
142, 143 
144, 145 


146, 147 


148, 149 
150, 151 
152, 153 


154—159 
160 
161 
162 
163-179 
180-185 
186-199 


200-215 
216-219 


220-254 





255, 256 


Reserved 
Spare 


Any disk 

8416 disk subsystem 

8418 disk subsystem (Mod-l) (low density) 
8418 disk subsystem (Mod-li) (high density) 
8430 disk subsystem 

8433 disk subsystem 

8414 disk subsystem 

8411 disk subsystem 


Any tape, no features specified 
Any tape, 9-track phase encoded 


Any tape, 9-track NRZI 
Any tape, 7-track NRZ! 


Slow tape, 9-track phase encoded 
Slow tape, 9-track NRZI 

Slow tape, 7-track NRZI 

Fast tape, 9-track phase encoded 
Fast tape, 9-track phase encoded 
Fast tape, 7-track NRZI 

Reserved 

Any diskette 

8413 diskette 

Reserved 

Any diskette, 128 byte 

Any diskette, 256 byte 

Any diskette, 512 byte 

Any diskette, 1024 byte 

Spare 

Double-density diskette 

Any diskette, autoload 

Any diskette, double-sided 
Reserved 

8415 disk subsystem-fixed 

8415 disk subsystem-removable 
8415 disk subsystem-fixed 
Reserved 

8424/8425 disk subsystem 


Reserved 


Any workstation 
Any workstation with 24 x 80 screen 


Spare 


Reserved 
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3.3.2. Printer Keyword Parameters 


| @ Keyword Parameter CHARSET: 


CHARSET=/EXT 





108 
Identifies the number of printable characters contained in the font set of the 
printer subsystem being described. 


CHARSET=EXT 


Identifies the font set as being an expanded character set for the 0770, 0773, 
and 0776 printers. 


Keyword Parameter PRINTPOS: 


PRINTPOS=( 428 (for 0773/0778/9200/9300) 
(for 0768/0770) 

144 
160 


, Identifies the number of print positions pertaining to the printer subsystem 







being described. 
Keyword Parameter LCB: 
Identifies the printer load code buffer that is to be used as the default buffer for the 


printer being defined. The various LCBs that may be specified for each type of 
printer are shown as follows. 


LCB=(63-S10 
OWNLC1 
OWNLC2 


For printer type 0768. 








For printer types 9200/9300. 


@ lf omitted, the appropriate default specification is assumed. 


OWNLC1 and OWNLC2 reference user-generated load code buffers. See 10.6 for 
the procedure to generate your own LCB for supervisor default use. 
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Keyword Parameter VFB: 


: 
ot 


VFB= JOWNVF i 


identifies the printer vertical format buffer that is to be used as the default 
buffer for the printer subsystem being defined. 


OWNVF 1 references the user-generated vertical format buffer. See 10.6 for the 
procedure to generate your own VFB for supervisor default use. 


Keyword Parameter VIRTUAL: 





PRINTER VIRTUAL =(2SABBRtBE 

® 

1-99 
If you configured your supervisor for spooling and if you specified at least one 
real printer, then you can allocate virtual printers in your system. When you 
specify virtual printers, you indicate that your supervisor schedules jobs based 
on the number of virtual printers rather than real printers in your system. To 
calculate the optimum number of virtual printers, multiply the number of jobs 
that can run concurrently by the average number of printer files used for each 
job. A maximum of 99 virtual printers can be specified, but you should note 
that each one uses 32 bytes of main storage. If you omit this parameter, the 
number of virtual printers that your system creates for spooling, by default, 
equals twice the number of job slots that you specified in the SUPGEN section. 
Be sure that you include the VIRTUAL printer keyword statement in the 
parameter set with PRINTER coded in the label field if you use this parameter 
to specify the number as different from the default value. 


3.3.3. Reader Keyword Parameters 


Keyword Parameter FEED: 


FEED=/51 
66 





on 
96 
Specifies the size of the cards to be read by the card reader. 


Keyword Parameter EOF: 


EOF=YES 
Indicates that the end-of-file feature is installed in the card reader being 
defined. This feature allows the card reader to sense an end-of-file condition 
regardless of whether the /* or //AFIN statement is missing from the job 
control stream. This applies only to a 1-job environment and is available only 
on the 0716 card reader. 
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Keyword Parameter DUALTRAN: 


DUALTRAN=YES 
Indicates that the dual translate is installed in the card reader being defined. 
This feature is available only on the 0716 or 0717 card readers. 


Keyword Parameter VALIDITY: 


VALIDITY=86. 


Indicates that no validity check feature is installed. It is the default specification 
when the reader is a 0716, 0920, 2703, 9200, or 9300 device. 





VALIDITY=YES 
Indicates that the validity check feature is installed in the reader being defined. 
It is the default specification when the reader is a O71/7 device. 


Keyword Parameter ALTSTACK: 





Re 
Be, 3 
ES 


Indicates that the alternate-stacker-fill feature is installed in the card reader 
being defined. 


Keyword Parameter MODE: 


MODE=/ASCII 
MPCD 
esepite 


eemegirenerecerstscerersisierers chaise efatohrateral 


















Indicates the mode of card interpretation of the reader as ASCII, COMPCD 
(compressed card code), or EBCDIC. 


Keyword Parameter VIRTUAL: 





"y 


READER vee 


1-99 

If you configured your supervisor for spooling and if you specified at least one 
real reader, you can allocate virtual readers in your system. (A diskette 
containing card images is also considered a real reader.) When you specify 
virtual readers, you indicate that your supervisor schedules jobs based on the 
number of virtual readers rather than real readers in your system. To calculate 
the optimum number of virtual readers, multiply the number of jobs that can 
run concurrently by the average number of reader files used for each job. A 
maximum of 99 virtual readers can be specified, but you should note that each 
one uses 32 bytes of main storage. If you omit this parameter, the number of 
virtual readers that your system creates for spooling, by default, equals the 
number of job slots that you specified in the SUPGEN section. Be sure that you 
include the VIRTUAL reader keyword statement in the parameter set with 
READER coded in the label field if you use this parameter to specify the 
number as different from the default value. 
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3.3.4. Punch Keyword Parameters 
Keyword Parameter READ/PUN: 
READ /PUN=YES 
Indicates that the read-before-punching feature is installed in the card punch 


being defined. 


Keyword Parameter VALIDITY: 





when the punch is a 0604, 0920, 9200, or 9300 device. 


VALIDITY=¥ES 
Indicates that the validity check feature is installed in the punch being defined. 
It is the default specification when the punch is a type O605 device. 


Keyword Parameter STACKSEL: 


STACKSEL=YES 
Indicates that the stacker-select feature is installed in the card punch being 
defined. 


Keyword Parameter VIRTUAL: 


SOTO TOTTI ITD ree. ientensiasaitinpeemnnaiacniaees 

NAT faa a OOO RIT BOSS RIO OO ONS ee. Petiee 

ce a Noa eS © = 2 x oe 3 . 

es SSOo Paoans Rn ie se 

ee oot SRR BOERS Gee SS See 6 Fae 4 
RIO Sor seers ss SSE oO RS SD SSIS ran aCe aS SS Sd 


If you configured your supervisor for spooling and if you specified at least one 
real card punch, you can allocate virtual card punches in your system. (A 
diskette to which you've written card images is also considered a real punch.) 
When you specify virtual punches, you indicate that your supervisor schedules 
jobs based on the number of virtual punches rather than real punches in your 
system. To calculate the optimum number of virtual punches, multiply the 
number of jobs that can run concurrently by the average number of punch files 
used for each job. A maximum of 99 virtual punches can be specified, but you 
should note that each one uses 32 bytes of main storage. If you omit this 
parameter, the number of virtual punches that your system creates for 
spooling, by default, equals the number of job slots that you specified in the 
SUPGEN section. Be sure that you include the VIRTUAL punch keyword 
statement in the parameter set with PUNCH coded in the label field if you use 
this parameter to specify a number different from the default value. 
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@ 3.3.5. Disk Keyword Parameters 


Keyword Parameter COCHAN: 


6 
Specifies that the disk being defined can be accessed by multiple channels to 
provide for simultaneous operation. This parameter is valid only for selector 
channel devices. 


aia 


Keyword Parameter COADDR: 


COADDR=address 
Specifies that the disk being defined can have multiple addresses to provide 
for simultaneous operation. Each address specified must be a 2-digit 
hexadecimal number. Multiple addresses must be separated by commas or a 
hyphen may be used to indicate consecutive addresses. The parameter is valid 
only for selector channel devices. 


Keyword Parameter SELACC: 


SELACC=/ 2-64 
(for sista teabbesiaioatinaaiens 
Specifies the maximum number of physical blocks on disk that may be written 
@ In one disk access when using the system access CCB mode (BCW 


commands). From 2 to 64 may be specified, depending on the multiblock I/O 
requirements of your applications. For each number of blocks specified for 
writing, approximately 3 times as many reads are provided for. This parameter 
may be used to optimize !/O for IRAM file applications or SPOOLBUFR 
specifications greater than 2. | 


Keyword Parameter SEEKSEP: 


aha 







ed NO 


ott o® 


< € x 


Specifies that you want your system to issue separate seek commands to disk 
to allow overlapping seek commands to more than one disk on the same 
control unit. This option increases |/O access time to disk. The default is YES. 


3.3.6. Tape Keyword Parameters 


Keyword Parameter COCHAN: 


aaa 
6 
Specifies that the tape unit being defined can be accessed by multiple channels 


& to provide for simultaneous operation. This parameter is valid only for selector 
channel devices. 
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Keyword Parameter COADDR: 


COADDR=address 


Specifies that the tape unit being defined can have multiple addresses to 
provide for simultaneous operation. Each address specified must be a 2-digit 
hexadecimal number. Multiple addresses must be separated by commas, or a 
hyphen may be used to indicate consecutive addresses. This parameter is valid 
only for selector channel devices. 


Keyword Parameter MODE: 


MODE=nn 
Indicates the recording mode of the tape unit being defined; also defines the 
tape unit as a Q-track or /7-track device. The entry must be a 2-digit 
hexadecimal number. Tables 3-2 and 3-3 show the 9- and 7-track mode 
settings that are supported. 


Table 3-2. 9-Track Recording Mode Settings 


ne 


Table 3-3. 7-Track Recording Mode Settings 


I/OGEN MODE=nn Values (hex.) 
Tape Parity 
200 bpi tape 556 bpi tape 800 bpi tape 


Only 
B 


Lae <a 
ee 


t Permits 8-bit channel data to be written to tape as 6-bit data with appropriate parity bit. 
Data bits O and 1 of the channel data are ignored during tape write and padded with 
zeros during tape read operations. 











Phase encoding 











Mode of Operation 








Normal! processing! 







Data conversion - 
processing? 





Data translation 
processing? 


NOTES: 


2. Permits reading and writing of disassembled 8-bit channel data on tape. 


3. Permits the reading and writing of 6-bit BCD data on tape to EBCDIC data for processing 
in the system. 
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Keyword Parameter TRANSLAT: 
TRANSLAT=YES | 
Indicates that the Extended Binary Coded Decimal Interchange Code to Binary 
Coded Decimal (EBCDIC to BCD) translate feature is being utilized. 
Keyword Parameter DENSITY: 


Indicates the recording modes of the tape unit being described. 





timers both the phase encoded and NRZI modes. It is the default 
specification when the tape unit is a type 10, 12, 14, or 16 device. 





identifies the non-return-to-zero (NRZI) mode. It is the default specification 
when the tape unit is a type 6 device. | 





Identifies the phase encoded mode. It is the default specification when the tape 
unit is a type 20 device. 
3.3.7. Workstation Keyword Parameters 


Workstation keyword parameters must be specified if your system supports interactive 
input from a local workstation. 


Keyword Parameter DESPACE: 


Specifies whether the space key protects or destroys the eialec tet. the cursor is” 
positioned on. 


DESPACE=YES 
Character is replaced with a blank when space key is pressed. 


DESPACE =8@ 
Character is not changed when space key is pressed. 





Keyword Parameter KATAKANA: 


KATAKANA=YES 


Specifies that your workstation recognizes input in the Japanese Katakana 
code. 
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3.3.8. Remote Workstation Keyword Parameters 


Remote workstation (REMWORKSTATION) keyword parameters must be specified if 
your system supports interactive input from a remote communications terminal. 


Keyword Parameter AMOUNT: 


AMOUNT=#-99 

Specifies the number of communications terminals that you want to support 
interactivity. If your communications network supports interactivity, you must 
specify how many terminals you want to function as remote workstations. You 
should note that the value you choose is the maximum number of interactive 
sessions that your system recognizes from remote terminals at any one time 
and should not be greater than the number of terminals in your system. Be 
sure to specify REMWORKSTATION in the label field. 


Keyword Parameter DESPACE: 


Specifies whether the space key protects or destroys the character the cursor is 
positioned on. 


DESPACE=YES 
Character is replaced with a blank when space key is pressed. 


DESPACE =i 
Character is not changed when space key Is pressed. 


Keyword Parameter SCRENMEM: 


Specifies single or dual screen support for remote workstations. 






aa 
ea, 
Be rt 


a 


“” 
>) 
a 
m 
= 
= 
m 
= 
i 


Indicates single screen support. 


SCRENMEM=2 : 
Indicates dual screen support. This allows full screen system messages on 
screen 1 when the workstation is not allocated to a job. Screen 2 is used for 
auxiliary input/output only. 


Keyword Parameter KATAKANA: 
KATAKANA=YES 


Specifies that your workstation recognizes input in the Japanese Katakana 
code. 
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6 3.3.9. Remote Printer Keyword Parameters 


Remote printer (REMPRINTER) keyword parameters must be specified if your system 
supports auxiliary printers that are connected to a remote workstation. 


Keyword Parameter AMOUNT: 





Specifies the total number of auxiliary printers that are connected to remote 
workstations in your system. 


3.4. SPECIFYING THE SYSTEM CONSOLE PRINTER 


You may include the system console printer in your |/O configuration by specifying COP 
as a label parameter in your I/OGEN section. 
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4. System Resident Volume 
Creation (RESGEN) 


4.1. GENERAL 


Your system resident (SYSRES) volume is configured by use of the RESGEN parameters 
described in this section. RESGEN enables you to place the output generated by the 
SYSGEN operation on any disk volume other than the OS/3 release volume (OS/3REL). 
If you don't want to create a new or remodeled SYSRES volume, simply omit the 
RESGEN section. The supervisor configuration generated by the SYSGEN operation is 
then stored in the system load library file (SBY$LOD) of the OS/3REL volume, which 
serves as your SYSRES volume. When you omit the RESGEN section, you may have to 
make modifications to the OS/3REL library files after the SYSGEN. Procedures for 
making these modifications are described in 10.8. 


lf you configure your system with a workstation or an_ interactive remote 
communications terminal, your system automatically transfers the various interactive 
products of OS/3 to your SYSRES volume during RESGEN. 


lf you wish to add a supervisor to your previously generated SYSRES volume, you will 
need a RESGEN section but should specify the NOPREP option. If you are not generating 
a supervisor but are simply configuring an emulator, an ICAM load module, or an NTR 
system utility module, you need not execute the RESGEN phase. There is an optional 
specification in the EMULAT, COMMCT, and NTRGEN keyword parameters that allows 
you to designate an output volume other than OS/3REL. 


The RESGEN parameters are keypunched onto cards or keyed in at a workstation and 
must immediately follow the statement with RESGEN coded in the label field. This 
statement signifies the beginning of the RESGEN section, which is delimited by the 
statement with END coded in the label field. A flowchart for this section is illustrated in 
Figure 4—1. 
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Figure 4—1. Flowchart for RESGEN Section 
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a 


© Format: 


LABEL AOPERATIONA 
RESGEN 





NOPREP oer | 
PARTIAL 


[ASM] [,BASIC]{£,BEMBAS][,BEMEDT][,BEMMON][,BEMRSP] 

[, COBEDT]{,COBOL](,COBL74][,DATAUTLI({,DDPFA][,DDPIMS] 
[, DDPTR]L,D0MSJ[,DSLT][,EDITOR]([,ESCORT][,EXTCOBOL] 

[, FORTRANJ(L,FORTIVIL, 1CAM][,IMSMT]([,IMSSTIJ[, IVP] 

[, LINKER] [,MENUS][,OCL][,OLM][,OLMC] 
[,0S4]£,RPGARPT][,RPGEDTJ[,RPGII][,SAM][,SFGEN] 

[, SORT][,SORT3]£,SPOOLIL,SY31[,SY32] 
SE 


a -{x0 
i + 


— 








[CATVSN=vsn] 


an +1- pet 
1-999 





me 
1-999 
dina weiss | 
1-999 
dicen ore 
1-999 
a pe 
1-999 


END 


4.2. RESGEN KEYWORD PARAMETERS 


Keyword Parameter SYSOUT: 


sYSOUT=[ [v FUE 
© s NOPREP 
PARTIAL 


Indicates that the SYSGEN output is to be placed on a disk pack other than the 
OS/3REL volume. Subparameters must be written in the order shown. 
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Positional Subparameters: 


vsn 
Specifies the volume serial number of the disk to receive the output created by 


system generation. Do not assign a vsn identical to that of the OS/3REL 
volume. 


If omitted, the name SYSRES is assigned by default. 


type 
Identifies the disk type receiving the output of system generation. This 
specification must agree with one of the TYPE specifications defined in the 
DISC category for |/OGEN (Section 3), except that, for the 8415 disk, you 
specify either 8415F (indicating the fixed portion) or 8415R (indicating the 
removable portion). 


If omitted, the parameter processor uses as the default specification the same 
disk type as that on which the current OS/3 release volume resides. 


NOTE: 


For the 90/30 B, you cannot IPL from a selector channel disk. 


pore 
PARTIAL 


Specifies the extent of disk preparation to be performed on the designated 
output volume (SYSOUT) being created or retailored. 








"Indicates a complete surface analysis is to be performed and a new BOOT 
block, IPL, and VTOC generated. 


NOPREP 
Indicates that you want to add the output of your SYSGEN to an existing 
SYSRES volume that was created from the current OS/3REL volume. When 
NOPREP is specified, all other keyword parameters in this section are ignored, 
and no library modules will be copied onto your SYSRES volume. 


PARTIAL 
Indicates no surface analysis is to be performed, but a new BOOT block, IPL, 
and VTOC are generated. 


If omitted, a complete surface analysis is performed and a new BOOT, IPL, and 
VTOC are generated. 
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Keyword Parameter CDIMODE: 


CDIMODE=YES 
Specifies that your system supplies only those program modules that support 
CDI data management. If you configure CDIMODE=YES, you must also specify 
DMGTMODE=CDI or MIXED during SUPGEN (2.2). 


Keyword Parameter DELETE or INCLUDE: 


DELETE }={ /[ASM][,BASIC]{,BEMBAS][{,BEMEDT][,BEMMON][,BEMRSP][,COBEDT] 

cael [,COBOL][,COBL74][,DATAUTL][,DDPFA][,DDPIMS][,DDPTRJ[,DMS] 
[,DSLT][, EDITOR] [,ESCORT)([,EXTCOBOLJ[,FORTRAN][,FORTIVJ[, ICAM] 
[, IMSMT][, IMSST](,1VP][,LINKER](,MENUS)([,OCL][,OLM][,OLMC] 
[,OS4][,RPGARPT][,RPGEDT][,RPGII](,SAM][,SFGEN] 
[,SORT][,SORT3]({,SPOOL][,SY31]([,SY32] 

[, UTSCOB][,UTSEP][,UTS400][,VSB1[,360/20EM][ ,92/93EM] 





zt9 g 


Bo 


OOO 





These parameters specify the system-supplied program modules (language 
processors, communications modules, utility modules, and diagnostic modules) 
that are to be copied onto your designated output volume (SYSOUT). You may 
specify the subparameters for either keyword parameter in any order or in 
multiple calls of the keyword itself. 


You can either use DELETE to exclude the modules you don’t want, or you can 
use INCLUDE to copy only the modules you do want. You cannot use both in 
the same RESGEN. | 


lf neither keyword parameter is used, or if you enter INCLUDE=ALL, all the 
system-supplied modules are copied onto SYSOUT. 


Subparameters: 
ASM 
Specifies the current BAL assembler. (The system macro library, $Y$MAC, is 


abbreviated as a result of assembler exclusion.) 


BASIC 
Specifies the current BASIC compiler modules. 


BEMBAS 
Specifies the current BEM BASIC compiler modules. 


BEMEDT 
Specifies the current BEM editor modules. 


BEMMON 
Specifies the current BEM monitor modules. 
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BEMRSP 
Specifies the current BEM remote spoolout processor modules. 


COBEDT 
Specifies the current COBOL EDITOR modules. 


COBOL 
Specifies the current basic COBOL compiler modules. 


COBL 74 
Specifies the current ANSI COBOL ‘74 compiler modules. 


DATAUTL | 
Specifies the current data utility modules. 


DDPFA 
Specifies the current distributed data processing file access modules. 


DDPIMS 
Specifies the current distributed data processing information management 
system transaction processing modules. 


DDPTR 
Specifies the current distributed data processing transfer facility modules. 


DMS | 
Specifies the current data base management system (DMS) modules. 
OSLT | 
Specifies the current dialog specification language translator modules. 
EDITOR 
Specifies the current general editor modules. 
ESCORT | 
Specifies the current ESCORT compiler modules. 
EXTCOBOL 
Specifies the current extended COBOL compiler modules. 
FORTRAN 
Specifies the current FORTRAN compiler modules. If you specify FORTRAN, 
you must also specify floating-point hardware during SUPGEN (2.2). 
NOTES: 


1. A basic FORTRAN compiler will not run under a supervisor that operates in a 
CDI only (DMGTMODE=CDI) data management environment. 


2. See 10.8.7 for special considerations for FORTRAN installations. 
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@ FORTIV 


Specifies the current FORTRAN IV compiler modules. 
NOTE: 
See 10.8.7 for special considerations for FORTRAN installations. 


ICAM 
Specifies the current ICAM modules. 


IMSMT } 
Specifies the current information management system multi-thread modules. 


IMSST 
Specifies the current information management system single-thread modules. 


IVP 
Specifies the current installation verification procedure modules. 


LINKER 
Specifies the current linkage editor modules. (The system object library file, 
$Y$OBJ, is abbreviated as a result of linker exclusion.) 


MENUS | 
@ Specifies the current menu services modules. 


OCL 
Specifies the current operating control language (OCL) modules. 


OLM 
Specifies the current online maintenance modules for the control system. 


OLMC 
Specifies the current online maintenance modules for communications. 


OS4 
Specifies the current Operating System/4 modules. 


RPGARPT 
Specifies the current RPG II auto-report modules. 


RPGEDT 
Specifies the current RPG Il editor modules. 


RPGII 
Specifies the current RPG II compiler modules. 


& SAM 
Specifies the 


current system activity monitor modules. 
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SFGEN 
Specifies the current screen format generator modules. 


SORT 
Specifies the current sort/merge modules. 


SORT3 
Specifies the current sort/merge modules for System/3. 


SPOOL 
Specifies the current spooling modules. 


SY3 
Specifies the current System/3 modules. 


SY32 
Specifies the current System/32 modules. 


UTSCOB 
Specifies the current UTS400 COBOL compiler modules. 


UTSEP 
Specifies the current UST400 edit processor modules. 


UTS400 
Specifies the current UTS400 upline link, load, and dump load modules and the 
upline dump and downline load procs. 


VSB 
Specifies the current verify system build modules. 


560/29EM 
Specifies the current 360/20 emulator modules. 


92/93EM 
Specifies the current 9200/9300 emulator modules. 


Keyword Parameter ATRANS: 
~ ATRANS=NO 


Specifies that an alternative transient file is not to be created on the SYSOUT 
volume for backup service. 
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Keyword Parameter COS: 


Specifies the version of control only storage (COS) that is copied from the 
current OS/3 release volume to the output volume SYSOUT. These versions 
have the following capabilities: 

1 =standard 1K COS. 

2 =standard 2K COS. 


3 =optimized 2K COS. This is part of an optional performance feature for 
90/40 processors only. 


If omitted, 1 is assumed. 
NOTE: 


COS version 1 (1K) does not support IMS, FORTRAN IV, extended COBOL, or 
COBL 74. 


Keyword Parameter FILELOCK: 





naman 
Specifies the number of files for which space is to be reserved for the storage 
of dynamic file lock share information in the file lock/share table (SYS$SHR). 
Maximum number of files is 999. 


Keyword Parameter CATVSN: 


CATVSN=vsn 
Specifies the volume serial number of the disk whose catalog file is to be 
copied onto the SYSRES being created. 


The following keyword parameters let you add to or override the computed cylinder 
sizes of your system library files. To add to the computed size, specify +n; to override 
the computed size, simply specify n as the cylinder size. If you do not specify these 
parameters, your system automatically computes the cylinder sizes of your system 
library files for you. 


Keyword Parameter $Y$LOD: 
eae ree 


1-999 
Specifies the cylinder size of your system load module library files. 
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Keyword Parameter $Y$JCS: 


dies ee 
1-999 
Specifies the cylinder size of your system job control stream library files. 


Keyword Parameter $Y$MAC: 


na oe 
1-999 
Specifies the cylinder size of your system macro library files. 


Keyword Parameter $Y$OBU: 
ae eit | 
1-999 


Specifies the cylinder size of your system object module library files. 


Keyword Parameter $Y$SRC: 


1-999 
Specifies the cylinder size of your system source module library files. 


am ee 
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5. Emulator (EMULAT) 
Configuration 


5.1. GENERAL 


The EMULAT section allows you to configure an emulator for your previous SPERRY 
UNIVAC 9200/9300 System or IBM 360/20 System at system generation time. This 
section allows you to submit the emulator descriptor statements and configuration options 
that describe your previous hardware and software configurations. It also details how your 
programs are to be emulated. The descriptor statements immediately follow the statement 
with the EMULAT parameter specified in the label field. This statement signifies the start 
of the emulator section, which is delimited by the statement with END coded in the label 
field. If SGSEMJCL is run in the spooling mode, the emulator JCL statements produced 
are preceded by two blank statements and a job accounting statement. These statements 
must be removed before using the parameter set to execute the emulator. 


It is not the intent here to explain the specifics of preparing the emulator descriptor 
statements; the process is an involved one and requires that you have _ sufficient 
background information to properly use the parameters associated with these statements. 
It is recommended, therefore, that you familiarize yourself with the emulation data 
presented in the 9200/9300 emulation/conversion user guide, UP-8063 (current version) 
or 360/20 emulation/conversion user guide, UP-8064 (current version) before attempting 
to use the EMULAT section. A basic flowchart for the EMULAT section is illustrated in 
Figure 5-1. 


Format: 


LABEL AOPERATIONA 


EMULAT 
[emulator descriptor statements ] 


END 








UP-8074 Rev. 11 SPERRY UNIVAC OS/3 5-2 
SYSTEM INSTALLATION 





START 











IS AN 

EMULATOR TO 
BE CONFIGURED 
IN YOUR SYSGEN? 























OMIT THIS 
SECTION 








SPECIFY 
EMULAT 


PREPARE APPLICABLE 
DESCRIPTOR CARDS 
AND CONFIGURATION 
OPTIONS AS DESCRIBED 
IN UP-8063 FOR 
9200/9300 OR UP-8064 
FOR 360/20 








SUBMIT EMULAT 
CONFIGURATION 








SPECIFY 


SECTION 
PARAMETER CARDS DELIMITER 
TO SG$PARAM (END) 


Figure 5—1?. Flowchart for EMULAT Section 
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5.2. CREATING THE EMULATOR LOAD MODULE 


The emulator load module is created by the job control stream SGSEMUMK, which when 
initiated by a keyin at the system console or workstation, assembles and links your 
particular emulator. This job control stream and the sequence in which it is to be executed 
in the SYSGEN process appears in the output listing prepared by the SGSPARAM job. The 
parameters for the EMULAT section may appear anywhere in the data stream of the 
SGSPARAM job, except between the SUPGEN and I/OGEN sections, or they may be 
submitted as the only data section to SGSPARAM. You have the option of submitting the 
EMULAT section with your supervisor configuration or as a separate section. Once 
SGSPARAM has prepared its sequenced list of job control streams to be executed, all 
those job control streams must be completed before you can configure another emulator 
(run SGSPARAM with the new EMULAT parameters). Therefore, only one emulator can be 
configured at a time. You may, however, resubmit the EMULAT section to SGSPARAM as 
many times as necessary to resolve errors. 


If you want to produce the job control statements required to execute your programs under 
the newly configured emulator, simply initiate the SGSEMJCL job control stream for each 
program to be emulated. This option is also listed in its proper sequence of execution by 
the SGSPARAM job. A diagnostic listing is provided following the processing of the 
emulator descriptor statements. 
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6. Communication (COMMCT) 
Configuration 


6.1. GENERAL 


The communication configuration parameters described in this section allow you to 
configure an integrated communication access method (ICAM) symbiont for your 
system. You have the option of submitting the COMMCT section with your supervisor 
configuration section or as a separate entity if only ICAM is to be configured. Only one 
COMMCT section may be configured at a time. That is, before you submit a second set 
of COMMCT parameters to the SGSPARAM for processing, you must do two things. 
First, you must execute the job control stream SGSCOMMK, which assembles and links 
your ICAM symbiont. Second, you must execute all the remaining job control streams 
specified in the sequenced list prepared by SGSPARAM. You may, however, resubmit 
the COMMCT parameters as many times as necessary to resolve errors. 


lf you want to use your ICAM terminals as interactive workstations, be sure to specify 
the following: 


m During SUPGEN (Section 2): 


- Specify values for the number of lines and adapters in your communications 
network (COMM parameter). 


— Specify all applicable interactive keywords. 
m During I/OGEN (Section 3): 

— Specify REMOTE workstations. 
= During COMMCT: 

— Specify CCA TYPE=(GBL,,node) (global network). 

— Specify LOCAP TYPE=(DMI) (demand mode interface); MT=YES (multitasking); 
IAS=(YES, OFF) (interactive services); and MODE=SYSTEM (remote 
workstation). 

— Specify TERM TCTUPD=YES (translate tables for interactive services) for any 


terminal (other than a remote workstation) that is used as an interactive 
workstation. 





UP-8074 Rev. 11 SPERRY UNIVAC OS/3 6-2 
SYSTEM INSTALLATION Update A 


In addition, be sure to use the field-protect feature on the terminal; otherwise, you will 
encounter errors when using interactive products. 


The OS/3 interactive services commands and _ facilities user guide/programmer 
reference, UP-8845 (current version), outlines what you need to know to use interactive 
services with your terminals as remote workstations. 


The COMMCT parameter formats are followed by Figure 6—1, which illustrates a basic 
flowchart for the COMMCT section. 









Format: 
LABEL AOPERATIONA 
COMMCT 
C—O "7 
CCAMOD=name (Note 2) 
MCP 
MCPNAME= (6% 
[MCPVOL=vsn] 
ACH=/(nn,network-name,line number ) 
nn, line speed '{ 
| [, SW 
(nn, DIALER[,eon]) 
[PIOST=(nn-1,...,nn-n)] 
[FASTLOAD=NO] 
[BPOOLEXP=NO] 
END 
NOTES: 


1. Each network definition must begin with a CCA macroinstruction and end with an 
ENDCCA macroinstruction. For example: 


CCA1 CCA Operands 


Network macroinstructions 


ENDCCA 
CCA2 CCA Operands 


Network macroinstructions 


ENDCCA 
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@ 2. Each CCAMOD parameter must be followed by an ENDCCA parameter. For 
example: 


CCAMOD=CCA' CCAMOD=CCA2 
ENDCCA ENDCCA 


START 


1S AN 














ICAM 
SYMBIONT NO OMIT THIS 
TO BE CONFIGURED SECTION 
IN YOUR 


SYSGEN 





YES 


SPECIFY 


COMMCT 


























PREPARE THE 










GENERATION 


CCAMOD AND 
USING AN EXISTING ENDCCA KEYWORD 
NETWORK DEFINITION PARAMETER 
SOURCE MODUL STATEMENTS 


PREPARE THE 
APPLICABLE 
NETWORK DEFINITION 
MACROINSTRUCTIONS 
AS DESCRIBED IN 
THE ICAM NETWORK 
DEFINITION AND 
OPERATIONS USER GUIDE 


PREPARE MESSAGE 
CONTROL PROGRAM 
(MCP) CONFIGURATION 
PARAMETER 
STATEMENTS AS 
DESCRIBED IN 
TEXT 


SUBMIT COMMCT 
CONFIGURATION 
PARAMETER 


SPECIFY 
SECTION 


DELIMITER 


©& (END) 


STATEMENTS 
TO SGSPARAM 





Figure 6—1. Flowchart for COMMCT Section 
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6.2. COMMCT PARAMETER DEFINITIONS 


The parameters used to define the COMMCT section are divided into two categories: 
network definitions and message control program (MCP) definitions. The network 
definition portion creates a communications control area (CCA) and includes the 
processing modules needed by ICAM. The MCP portion specifies the name of the ICAM 
symbiont, the disk volume where you want it stored, and the characteristics of each 
communications line. 


6.2.1. Network Definition 
You may code the network definition part of COMMCT in two ways: 


1. Coding network definition macroinstructions as described in the ICAM network 
definition and operations user guide, UP-8947 (current version). 


2. Coding the CCAMOD keyword parameter to include a previously saved network 
definition source module. 


An ICAM symbiont may contain as many as four logical network definitions plus one 
physical network definition. This means you may include up to four sets of network 
definition macroinstructions or four CCAMOD parameters (or a combination adding up to 
four in the COMMCT section, plus an additional network definition or CCAMOD 
parameter for a physical network. The logical network definitions support three ICAM 
interfaces: standard (STDMCP), transaction control (TCI), and direct data (DDI). A 
physical network definition supports only the communications physical interface (CPI). In 
addition, a global (GBL) specification allows for a mixture of interfaces within a single 
network. 


As we discussed in the introduction section, SG$PARAM performs syntax and illogical 
situation checking. For the COMMCT phase, it checks to see that you have correctly 
spelled all of the operands, that you coded them in the correct places, and that you 
have not specified a network that is impossible to configure. For example, the 
parameter processor checks to make certain that a dialed line is possible if you specify 
a telephone number, because some terminals are never used on dialed lines. 


In cases where you make illogical or inconsistent choices, the parameter processor 
substitutes default values for you. And it flags these substituted values for you in its 
Output listing. Obviously, you are the best judge of whether a substitution is correct for 
your situation. When generating a communications symbiont be sure that the SYSGEN 
parameter processor provides correct default substitutions for the ICAM element that 
you want to generate. 


The ICAM network definition and operations user guide, UP-8947 (current version) 
describes the default values for the COMMCT phase. 
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6.2.1.1. Writing a New Network Definition 


This manual does not describe the ICAM network definition macroinstructions, but only 
their use in generating the ICAM symbiont. You should familiarize yourself with the 
ICAM network definition and operations user guide, UP-894/7 (current version) before 
attempting to configure an ICAM symbiont. The network definition macroinstructions 
immediately follow the statement with COMMCT coded in the label field. Each network 
definition starts with a CCA = macroinstruction and ends with an ENDCCA 
macroinstruction. A physical |/O only CCA macroinstruction must be the last CCA in a 
multiple CCA generation. 


With the exception of the MCP portion of COMMCT, which is presented in 6.2.2, the 
coding of network definition macroinstructions follows the OS/3 assembler coding rules. 
These rules apply: 


m= Each operand is followed by a comma, except the last operand. 
w Multiple operands may be specified on one statement. 


= =A macroinstruction may be continued on additional statements by using standard 
continuation conventions. 


s An operand, its specification, and its trailing comma (if required) must start and end 
on the same statement. 


6.2.1.2. Using an Existing Network Definition 
Keyword Parameter CCAMOD: 


CCAMOD=name 
Specifies the 4-character name of a previously saved network definition in the 
system source library file (SY$SRC) of your SYSRES volume or the OS/3 
release volume (OS/3REL). You specify this source module with the CCAMOD 
parameter in place of network definition macroinstructions. Each CCAMOD 
parameter must be followed by an ENDCCA parameter. 


6.2.2. MCP Keyword Parameters 


The MCP portion of COMMCT must begin with MCP coded as a nonlabel parameter. 
This parameter functions as a delimiter that signifies the end of the network definition 
and the start of the MCP parameters. The MCP parameters and the COMMCT section 
are delimited by the END statement coded in the label field. The MCP parameters differ 
in format from the network definition macroinstructions because they follow the 
SYSGEN coding rules. That is, they are delimited by blank characters, and_ their 
parameters can be submitted on separate statements without continuation indicated. In 
other words, be sure to leave column 72 blank. 
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Keyword Parameter MCPNAME: 


MCPNAME= 
Mn 





Identifies the indexed name of the ICAM symbiont, where n is a decimal 
number from 1 to 9. A maximum of 18 ICAM symbionts may be maintained 
on a given SYSRES volume. Duplicate names are not possible, as the name 
specified replaces a previous symbiont of the same name. The name is used to 
initiate the loading of the ICAM symbiont through the supervisor symbiont 
loader technique. 


Keyword Parameter MCPVOL: 


MCPVOL=vsn 


Specifies the volume serial number for the SYSRES volume on which the ICAM 
symbiont is to reside. The symbiont is copied into the $Y$LOD library of the 
specified volume. 


lf omitted, the volume serial number defaults to that of the OS/3 release 
volume. 


Keyword Parameter CACH: 


The MCP keyword parameter CACH describes each line adapter that the ICAM 
symbiont accesses or supports on the communications adapter (CA). It has three 
formats that identify line adapters used by communications lines, dialers, and virtual 
channels. 


Format 1 is the easiest to use; it lets system generation access your ICAM 
network definition and determine the line adapter requirements automatically. If 
you use this format to define an automatically-dialed (for output) switched line, 
do not also specify a format 3 CACH statement for the dialer line adapter. 


Format 2 lets you explicitly define the requirements for a line adapter that will 
carry data. When you use it to define an automatically-dialed switched line line 
adapter you must also include a format 3 CACH statement to define the dialer 
line adapter. Communications physical interface (CPI) users and universal data 
link control (UDLC) intelligent line adapter (ILA) users must use this format. 


Format 3 defines dialer line adapters. You only need to use this format when 
you have used format 2 to define a line adapter for an automatically dialed 
switched line. 


Logical network users (including global network users) may specify either Format 1 
or Format 2 for line adapters used by communications lines. Communications 
physical interface (CPI) network users and UDLC intelligent line adapter users must 
use Format 2. Format 3 is used in conjunction with Format 2 and describes a dialer 
line adapter. You use it only when the auto dial capability is included for a 
communications line. 
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© Because ICAM supports local workstations that do not require CACH information, 
the CACH parameter is optional if you specified COMM=YES during SUPGEN (2.2). 


Format 1: 


CACH=(nn,network -name, l ine-number ) 


where the positional subparameters are: 


nn 


A 2-digit decimal number identifying the CA port. 


network -name 
Specifies the 4-character name used in the label of the CCA macro. 


Line-number 
A 2-digit decimal number identifying a line that uses this port by its order 
in the network definition; i.e., the line-number of the first line defined in 
the network definition is O01. If autodial capability is specified for this line 
by the DIALER operand of the LINE macroinstruction, an auto-dial port is 
generated automatically. | 
© For example, in the following partial network definition: 


CCA1 CCA 
LNE1 LINE ...,TYPE=(2400,SWCH,SYNC),... 


LNE2 LINE ...,TYPE=(9600,SYNC),... 


these CACH statements would be appropriate in the MCP: 


CACH=(06,CCA1, 1) 
CACH=(07,CCA1,2) 





Format 2: ' 
aia i line-speed =) oes (, SWITCHED][,SYNCIL, a“ 
where: 


Is a 2-digit decimal number identifying a CA port. 
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Line-speed 
Is a decimal number that specifies the maximum baud rate obtainable in 
the CA subchannel. The rates are listed in Table 6—1. 


If this operand specifies a virtual channel (a VLINE), you must specify the 
same line speed value you specified in the TYPE operand of the applicable 
VLINE macroinstruction. 


FULL 
Specifies 2-way simultaneous transmission (full-duplex operation) using 
two CA ports. You must specify FULL for virtual channel lines. 


lf you omit this operand, 2-way alternate transmission (half-duplex 
operation) is assumed by default. 


NOTE: 


lf an ICAM remote device handler uses 2-way-alternate protocol 
(half-duplex), the line must be defined as 2-way-alternate also. All ICAM 
remote device handlers utilize 2-way-alternate protocol except NTR, UDLC, 
ABM, and level 2 X.25 public data networks. 


lf 2-way simultaneous protocol is used, the same protocol must be — 
specified in the ICAM generation (LINE and CACH). 


2-way simultaneous modems and lines may be used with 2-way-alternate — 
_ protocol if required. 


AUTODIAL,nn,eon 
Specifies that automatic dialing is to be performed. Also indicates that the 
data transfer port being defined has a dial adapter port associated with it 
to which dialing operations are directed. 


lf omitted, manual dialing is assumed or the line is a private line. 


nn 
Is a 2-digit decimal number of the port to which the dialing adapter is 
attached. 
NOTE: 
nn=04 to 15 and 20 to 317 (indicates where the dial adapter is attached 
for the port). 

eon 


Specifies an end-of-number code if required by the automatic calling unit. 
Refer to the operating instructions for your automatic calling unit for the 
required characters. 
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Table 6—1. Line Speed Values 


User-Specified CA Hardware 
Value in CACH Required Value 


Asynchronous Line Speeds | 


Synchronous Line Speeds 


Any decimal value Any decimal value 
less than 2000 less than 2000.0 

2000 2000.0 

2400 2400.0 

4800 | 4800.0 

7200 7200.0 

9600 9600.0 

19,200 | 19,200.0 

48,000 48,000.0 

56,000 56,000.0 

64,000 64,000.0 





SWITCHED 
Indicates that the port supports switched network facilities only. 


lf omitted, dedicated line services are assumed. 


SYNC 
Specifies that synchronous operation is supported on this port. 


lf omitted, asynchronous operation is assumed. 


ILA 


Specifies that the Sperry Univac intelligent line adapter is used for 
bit-oriented procedures. 
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NOTE: 

For 2-way, simultaneous lines, specify the even-numbered port; the odd-numbered 
port is automatically assigned. For intelligent line adapters, specify the 
odd-numbered port; the even-numbered port is automatically assigned. If you 
specify combinations of these lines, be sure that automatic assignments don't 
duplicate ports. 

For example, in the following partial network definition: 


CCA1 CCA ace 


LNE1 LINE ...,TYPE=(2400,SWCH,SYNC),... 


LNE2 LINE ...,TYPE=(9600,SYNC),ID=07,... 


VLN1 VLINE ...,TYPE=(9600,ILA,FULL),ID=05,... 


these CACH statements would be appropriate in the following partial MCP: 


CACH=(05, 9600, ILA, FULL) 
CACH=(06, 2400, SWCH, SYNC) 
CACH=(07,9600,SYNC) 


Format 3: 


CACH=(nn,DIALER[,eon] ) 


where the positional subparameters are: 


nn 
A 2-digit decimal number identifying the CA port used by the automatic 
calling unit. 

DIALER 


Specifies that an autodial adapter resides in this port. 
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eon 
- Specifies an end-of-number code if required by the automatic calling unit. 
Refer to the operating instructions for your automatic calling unit for the 
required characters. 


Keyword Parameter PIOST: | 


PIOST=(nn-1,...,nn-n) 
nn | 


A 2-digit decimal number identifying the address of the CA port that will 
receive priority interrupt handling. Up to seven ports may be specified. 


Keyword Parameter FASTLOAD: 


FASTLOAD=NO © | | 
Indicates that your ICAM symbiont suppresses the improved overlay loading 
facility. Suppressing this facility forces ICAM to perform a directory search 
each time it loads an overlay, instead of only the first time it loads that 
overlay. 


Keyword Parameter BPOOLEXP: 


BPOOLEXP=NO 
Specifies that the dynamic buffer pool services expansion routine (BPSX) is not 
included in the ICAM generation. If you omit this parameter, the BPSX routine 
is automatically included in the generation. BPSX is not included for a transient 
TCi only or a CPI only ICAM. 
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7. NTR System Utility Module 
Generation (NTRGEN) 


7.1. GENERAL 


The NTR system utility module generation parameters described in this section allow 
you to configure an NTR (nine-thousand-remote) system utility load module for your 
system. An NTR system utility load module must be generated whenever a SPERRY 
UNIVAC Series 90 Data Processing System operating under OS/3 is going to be used 
as a remote device by a SPERRY UNIVAC 1100 Series Data Processing System. (For 
more information on the capabilities and operation of NTR, refer to the current version 
of the integrated communications access method (ICAM) utilities user guide, UP-8552.) 


The NTRGEN phase of SYSGEN processes two distinct groups of keyword parameters: 
NTR keywords and LOCAL keywords. NTR keywords are used to define the general 
characteristics of the NTR module to be generated. LOCAL keywords define remote 
device handlers for the NTR module. Only one set of NTR keywords may be present in 
a SYSGEN run. Up to 14 sets of LOCAL keywords may be present. The NTR keywords 
are applicable to all the LOCAL sets provided for the generation of an NTR system utility 
generation module. The LOCAL keywords are unique to their respective set. 


The first statement in the NTR generation set must be a statement with NTRGEN coded 
in the label field. This statement signifies the beginning of the NTR section. Following 
this statement are the statements containing the NTR and LOCAL keywords. Each set of 
statements is preceded by a label statement that identifies that particular group of 
keywords; the NTR set is preceded by a statement with NTR coded in the label field, 
and each LOCAL set is preceded by a statement with LOCAL coded in the label field. 
The last statement in the NTR generation set must be a statement with END coded in 
the label field to delimit the NTR section. 


NTRGEN has the ability to accept and process various input NTR and LOCAL keyword 
set configurations. NTR keyword data may be followed or preceded by up to 14 sets of 
LOCAL keyword data, or NTR or LOCAL keyword data sets may be processed alone. 
This provides you with the ability to preprocess LOCAL keyword data sets and then link 
them with the NTR module when the NTR keyword data is processed. The job streams 
needed to produce an NTR system utility module are only produced when NTR keyword 
data is processed by NTRGEN, whether or not LOCAL keyword data sets are present. 
When the NTR section is omitted, LOCALS can be preassembled for future use by 
running the jobstream SGSNTRMK. 
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In order for an NTR system utility module to be executed, an ICAM load module must 
have been generated with the following communication configuration (COMMCT) 
parameters: CCA TYPE=NTR, LINE DEVICE=NTR, and TERM FEATURES=NTR. 


The supervisor used when executing the NTR system utility must have the following 
modules resident: 


SM$ATCH 
SM$LOCK 

SMSSTXIT 
SM$TASK 


These are specified through the RESMOD parameter at supervisor generation time (see 
Section 2). 


A basic flowchart for generating an NTR system utility load module is illustrated in 
Figure 7-1. 






NTR SYSTEM 

UTILITY LOAD MODULE 

TO BE CONFIGURED IN 

YOUR SYSGEN 
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NO OMIT THIS 









SECTION 
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RIATE COMMCT CON- 
FIGURATION STATEMENTS 


AS DESCRIBED IN SECTION 
6 AND GENERATE THE 
ICAM LOAD MOOULE 
























PREPARE UP TO 14 
SETS OF LOCAL 
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STATEMENTS 
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STATEMENTS TO 
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SPECIFY 
SECTION 
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Figure 7—1. Flowchart for NTRGEN Section 
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LABEL AOPERATIONA 

NTRGEN 

NTR 
— -NTR-name '{ S \)] 
NTRNAME=ntrname 
[NTRVOL=vsn] 


BLOCKIN=lLine-buffer-size (9999 max) 
[BLOCKOUT=l ine-buffer-size (9999 max)] 


' — te 1 


LINE=l i1ne-name (Must be the same as CCA label name) 





NET=network -name (Must be the same as CCA label name) 
SITE=id 


leone S i 


C[PRTSPnn=hh] 
[NPRTSPnn=hh] 
LOCAL TASKNAME=taskname 
@ BLKSIZE=image-buffer-size 





DEVICE=n 


ie a 


LFD=filename 









p 
PUNCH 


VFBLEN=(n 

bee“! 
& 

—s 


[VFBFORM=formname] 


Vf ma, 
< 
U7 
m 
ik 
Pe 


END 
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7.2. NTRGEN PARAMETER DEFINITIONS 


The parameters used to define the NTRGEN section are divided into two categories: the 
NTR keyword parameters and the LOCAL keyword parameters. A description of these 
keywords is provided in 7.2.1 and 7.2.2. A detailed description of these keywords and 
the functions they invoke is contained in the integrated communication access method 
utilities user guide, UP—8552 (current version). 


7.2.1. NTR Keyword Parameters 


Keyword Parameter NTRMOD: 





NTRMOD=old-NTR-name {a} 
Identifies a previously generated NTR network by name and module type, so it 
may be linked with the LOCAL keyword sets being processed in the current 
run. If used, NTRMOD must be the first keyword specified in this section; all 
other parameters except NTRVOL, NTRNAME, and TASK are ignored, and a 
diagnostic message is written in the output listing. 


Positional Subparameters: 
old-NTR-name 


Specifies the name of the previously generated NTR module and does not 
include any LOCAL keyword parameter sets. 


Identifies a source module. 


Identifies an object module. 


If omitted, it is assumed that the NTR module is an object module residing in 
$Y$OBJ on OS/3 REL. 


Keyword Parameter NTIRNAME: 


NTRNAME=ntrname 
Specifies the name of the NTR network being generated. 


Keyword Parameter NTRVOL: 


NTRVOL=vsn 
Specifies the volume serial number for the SYSRES volume on which the NTR 
system utility module is to reside. The NTR module is copied into the $Y$LOD 
library of the specified volume. 


If omitted, the volume serial number defaults to that of the OS/3 release 6 
volume. 
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Keyword Parameter BLOCKIN: 


BLOCKIN=l ine-buffer-size 
Specifies the line-buffer size in bytes for transmission from the 1100 system 
to the OS/3 system (SOH through BCC) as specified by the 1100 system. For 
the 1100 system versions 33 and earlier, the line-buffer size is either 240 
bytes or 246 bytes when through half-word CTMC; for later versions, this 
value is configurable and should not exceed 9999 bytes. 


Keyword Parameter BLOCKOUT: 


BLOCKOUT=L ine-buffer-size 
Specifies the line-buffer size in bytes for transmission from the OS /3 eyvetein to 
the 1100 system (SOH through BCC) as specified by the 1100 system. For the 
1100 system versions 33 and earlier, the line-buffer size is 121 bytes; for later 
versions, this value is configurable and should not exceed 9999 bytes. 


lf omitted, the value specified for BLOCKIN size is assumed. 
Keyword Parameter LINESP: 


LINESP=[n 





Specifies the line speed being used. 
Keyword Parameter LINE: 


LINE=l ine-name 
Specifies the same line-name appearing as the label in the LINE macro under 
the CCA definition in the ICAM generation. 


Keyword Parameter NET: 


NET=network-name 
Specifies the same network-name appearing as the label for your CCA 
definition in the ICAM generation. 


Keyword Parameter SITE: 


SITE=id 
Specifies the full 6-character site identification (id) number configured for your 
1100 series system. The OS/3 processor uses this ‘id’ for sign on (translated 
to truncate ASCII with odd parity). The operator, during execution of the NTR 
utility, can override this keyword parameter by use of the SIGN-ON key-in as 
described in the ICAM utilities user guide, UP—8552 (current version). 
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Keyword Parameter TASK: 


aun > 
Identifies a 1- to 6-character name and module type (source or object) of a 
previously generated NTR remote device handler. This keyword may be 
specified up to 14 times. The total TASK keywords plus LOCAL keyword sets 
may not exceed 14. Only object modules are permitted for user-own-code 
tasks. 


Positional Subparameters: 


taskname 
Specifies a taskname not given in this run but defined by a previous LOCAL 
keyword parameter TASKNAME, or an _ object module name of a 
user-own-code task. 


Specifies the LOCAL task was placed in $Y$SRC of your SYSRES volume by a 
previous SGSPARAM job and must be assembled by the SGSNTRMK job 
stream. 


lf omitted, it is assumed that the module is an object module that resides in 
SYS$OBJ on OS/3REL. 


Keyword Parameter PRTSPnn=hh: 


Specifies, for printer-type devices only, a hexadecimal byte used for space 
compression when TRANS=NO. This value corresponds to the 2-digit, decimal 
function codes (nn) listed in Table 7-1. 


For example, PRISPO3=20 indicates that hexadecimal 20 is the space 
character for printers with function code O3 when the LOCAL keyword 
parameter TRANS=NO. 


Keyword Parameter NPRTSPnn=hh: 


Specifies, for nonprinter-type devices only, a hexadecimal byte used for space 
compression or decompression when TRANS=NO. This value corresponds to 
the 2-digit, decimal function codes (nn) listed in Table 7-1. 


For example, NPRTSPO5=O5 indicates that hexadecimal O05 (field data space) is 
the space character for all nonprinter-type devices with function code 05 when 
the LOCAL keyword parameter TRANS=NO. 
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@ 7 Table 7—1. Space Compression Characters 


hh (hexadecimal) 
Printer Nonprinter 
(PRTSP) (NPRTSP) 






7.2.2. LOCAL Keyword Parameters 


Keyword Parameter TASKNAME: 


© TASKNAME=taskname 
Specifies a 1- to 6-character name used to identify the NTR remote device 
handler being generated by this set of LOCAL keywords. 


Keyword Parameter BLKSIZE: 


BLKSIZE=image-buffer-size 
Specifies the maximum image buffer size for the unit record device; this size 
should be a multiple of 12 for the card punch. 


Keyword Parameter COMPRESS: 


COMPRESS=NO 
Specifies that the space compression option is not included for the 
reader/input device (TYPE) sending data to your 1100 series system. 


lf omitted, space compression is performed on all data sent to your 1100 
series system by the reader/input device defined in the TYPE keyword 
parameter. The space compression character is defaulted to X'40’' (EBCDIC 
space) when TRANS=YES, or taken from the NTR space compression table 
(Table 7-1) when TRANS=NO. 


Keyword Parameter DEVICE: 


_ | DEVICE=n 


Specifies the local device numbers for the NTR remote device handler being 
generated by this set of LOCAL keywords. This parameter must agree with the 
1100 system device number. 
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Keyword Parameter FUNCD: 


es 


x ae 
poset co 





Specifies a 2-digit decimal function code that establishes the translation 
requirements for each image sent to your 1100 system. This parameter is 
used in conjunction with the TYPE and TRANS keyword parameters. The 
function codes and their respective meanings are listed for both input and 
Output device types in Table 7-2. 


Table 7—2. Device Function Codes 


Function 2; = (2) 
TRANS=YE TRANS=N 
Code © 


Card Readers and Input Devices 





































Hex fieldata@) Fieldata Fieldata 
EBCDIC Fieldata Fieldata 
Hex fieldata @) ASCII ASCII 
EBCDIC ASCII ASCII 
EBCDIC Fieldata Fieidata 
EBCDIC ASCII ASCII 













Card Punches and Nonprinter Output Devices 


Receive Punch Receive 





















Fieldata Hex fieldata@) Fieldata 
Fieldata EBCDIC Fieldata 
ASCII Hex fieldata ASCII 
ASCII EBCDIC ASCII 
Fieldata EBCDIC Fieldata 





ASCIl EBCDIC ASCII 




















Fieldata EBCDIC Fieldata 
ASCIli EBCDIC ASCII 
Fieldata EBCDIC Fieldata 


ASCII EBCDIC ASCII 


NOTES: 


GC) The function code is controlled by the 1100 system for all data sent to NTR. 


Q) For TRANS=NO, NTR passes the data untranslated. Fieldata/ASCII is the standard 
1100 correspondence for the device type and function code. 


(3) Hex fieldata is the hexadecimal equivalent of fieldata (Hollerith punch card codes). 
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Keyword Parameter LFD: 


LFO=filename 
Specifies the filename as it appears on the // LFD job control statement. 


Keyword Parameter TRANS: 


TRANS=NO | | 
Specifies that the NTR translation feature is not included for the device type 
defined by the TYPE keyword parameter. (Space compression character is 
determined by function code. See Table 7—1.) | _ | 


lf omitted, the images sent to or received from your 1100 system are 
translated, respectively, to or from EBCDIC according to function code (FUNCD 
keyword parameter). Space compression character is defaulted to the EBCDIC 
space (X‘40’). 


Keyword Parameter TYPE: 


TYPE= (REASER 
PRINTER 


PUNCH 


Specifies the device type for the NTR remote device handler being generated 
by this set of local keywords. 





NOTE: 


Because system-supplied NTR locals use unit record system access technique, to 
access a diskette instead of a card reader or punch, you must write your own locals 
that use standard data management. To do so, see ICAM utilities user guide, UP-8552. — 


Keyword Parameter VFBLEN: 





iba 


Specifies the number of lines (1 to 192) on the printer form. 


Keyword Parameter VFBDEN: | 


ieee 


Specifies the number of print lines per inch (6 or 8). 
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Keyword Parameter VFBHOME: 


maa 


Specifies the location (line 1 to line 192) of the home paper position, which is 
the position where the first line of printer output is placed on each form (page). 
The value specified must not exceed the value specified by the VFBLEN 
keyword parameter. 


Keyword Parameter VFBFORM: 


VFBFORM=formname 
Specifies the name (1- to 8-alphanumeric characters) to be associated with the 


form. A console message tells the operator to load this form on the printer. If 
omitted, no name is associated with the form. 
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8. COBOL Option Values 
Generation (COBGEN) 


8.1. GENERAL 


The parameter specifications described in this section allow you to configure processing 
option values for the ANSI'74 COBOL compiler (different from the standard option 
defaults). The parameter processor accepts and validates each COBGEN parameter, flags 
invalid specifications as errors, and substitutes the standard default options in their 
places. The changes specified affect the compiler on: 


= the volume specified by the SYSOUT parameter in the RESGEN section (Section 4) 
if included as part of the SYSGEN operation; or 


m the release volume if the RESGEN section is not part of the SYSGEN operation. 


For more information on COBGEN, see the 1974 ANSI ‘74 COBOL programmer 
reference, UP-8613 (current version). 


The COBGEN parameter specifications are keypunched onto cards or keyed in at the 
workstation and must be immediately preceded in the control stream by a statement 
with COBGEN coded in the label field. This statement signifies the beginning of the 
COBGEN section. The COBGEN section is delimited by a statement with END coded in 
the label field. 


A basic flowchart for changing standard eptom: defaults used by the ANSI ‘74 COBOL 
compiler is shown in Figure 8—1. 
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CONFIGURE 
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(See 8.2.) 
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Figure 8-1. Flowchart for COBGEN Section 
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(continued) 
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LABEL OPERATION 





COBGEN 
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Ps 
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1 


(continued) 


8-3 
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£,OPERATIONA 








COBGEN = 

oe ida b= 
nuevo 

END YES 


8.2. COBGEN KEYWORD PARAMETERS 
Keyword Parameter AXNON: 
AXNON=YES 
Suppresses nonreferenced ' entries in the  alphanumerically ordered 
cross-reference listing. 


Keyword Parameter AXREF: 


AXREF=YES 
Specifies an alphanumerically ordered cross-reference listing. 


Keyword Parameter CALLST: 
CALLST=YES 
Specifies that subprograms named by the literal option of the CALL statement 
are to be linked with the main program. 


Keyword Parameter CDMIO: 


CDMIO=NO 
Specifies that DTF interfaces will be used for all files except workstation files. 





Specifies that consolidated data management (CDM) will be used for all files 
except ISAM and SAM disk files. 


CDMIO=MI 


Specifies that CDM interfaces will be used for MIRAM and workstation files 
only; DTF interfaces will be used for all other files. 


This parameter is applicable only for a system that supports both CDM and DTF 
interfaces. 


Keyword Parameter CMCSST: 


CMCSST=YES 
Specifies that the COBOL communications contro! module is bound with the 
COBOL object program. 








UP-8074 Rev. 11 SPERRY UNIVAC OS/3 8-5 
SYSTEM INSTALLATION 





Keyword Parameter CPYTXT: 


CPYTXT=NO 
Specifies that copied COBOL library text is not to be included in source listing. 


Keyword Parameter DIAG: 


DIAG=NO 
Specifies diagnostic listing is not to be prepared. 


Keyword Parameter DIAGWN: 


DIAGWN=NO 
Specifies that warning diagnostics are not to be included in diagnostic listing. 


Keyword Parameter FIPS: 

FIPS=/1 
2 
3 
4 
Specifies FIPS PUB 21-1 flagging options. 


For more information about these options, refer to Appendix D, OS/3 ‘74 
ANSI COBOL programmer reference, UP—8613 (current version). 


Keyword Parameter IMSCOD: 
IMSCOD=YES 
Specifies IMS compatible code. (COBOL programs are executed under control 
of IMS as action programs. The COBOL language elements restricted by IMS 
are flagged and deleted.) 


Keyword Parameter IN: 


IN=module ing, 





BB Oe: ak nde ie 
BB. Be OR Se Bae 
bi Soar RR cite, at 


Specifies a 1- to 8-character name of a source module in the library and the 1- 
to 8-character LFD name identifying the file in which that module resides. 


Keyword Parameter LIN: 


— 


SARS 
ae dao ta 





Specifies a 1- to 8-character LFD name that identifies the file on which the 
COPY library resides. This name is used if the library name is omitted from the 
COPY statement. Do not specify LIN if you are using JPROCS. 
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Cod 


Keyword Parameter LIST: 


LIST=NO 
Specifies source program listing is not produced. 


Keyword Parameter LNKCON: 


LNKCON=NO 
Specifies linker control statements are not included in object module. 


Keyword Parameter LSTREF: 


LSTREF=YES 
Specifies a source listing with definition references. 


Keyword Parameter LSTWTH: 
LSTWTH=120-160 
Specifies listing page width in number of characters printed per line. Values 
range from 120 to 160 characters per line. The default value is 120 
characters. 


Keyword Parameter MAP: 


MAP=YES 
Specifies an object program locator/MAP listing. 


Keyword Parameter MXNON: 


MXNON=YES 
Suppresses nonreferenced entries in the MAP listing with cross-references. 


Keyword Parameter MXREF: 


MXREF=YES 
Specifies MAP listing with cross-references. 


Keyword Parameter OBJ: 





ES. és eh S ee 


Se tS 


Specifies a 1- to 8-character LFD name of the file on which the generated 
object module is to be stored. 


Keyword Parameter OBJLST: 


OBJLST=YES 
Specifies an object program listing. 
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Keyword Parameter OBJMOD: 


OB JMOD=NO 
Suppresses production of an object module. 


Keyword Parameter PAGOVEF: 


PAGOVF=YES 
Specifies automatic printer page eject in the object program. 


Keyword Parameter PROVER: 


PROVER=YES 
Produces a listing of procedure names and verbs with associated source line 
numbers and object program relative addresses. _ 


Keyword Parameter SPRLST: 
SPRLST=YES 
Suppresses all listings unconditionally. This parameter overrides all other listing 
specifications. 


Keyword Parameter SPROUT: 


SPROUT={ 1 





Suppresses compiler output (except source listing, diagnostic listing, and 
related options) when severity code level 1, 2, or 3 errors are encountered. 


Keyword Parameter SYNCHK: 


SYNCHK=YES | 
Specifies syntax check compile only. When SYNCHK=YES, the compiler 
produces only source program and diagnostic listings. 


Keyword Parameter TRNADR: 


TRNADR=NO 


Suppresses generation of a transfer address in the object module, in which 
case, the program cannot be executed unless it is called. _— 


Keyword Parameter TRUNC: 


TRUNC=NO 
Specifies that data truncation and detection of SIZE ERROR on binary and 
packed decimal items are based on the actual storage size allocated to those 
items. If omitted, data truncation and detection are based on the specified 
decimal digits in the PICTURE character string. 


s 





PART 3. SYSGEN EXAMPLES, OPERATING 
PROCEDURES, AND STATEMENT 
CONVENTIONS 
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9. System Generation 
(SYSGEN) Examples 


9.1. GENERAL 


The coding samples described in 9.2 through 9.7 show typical examples of system 
generation (SYSGEN) for OS/3. They include creating a basic supervisor on the OS/3 
release volume; creating a tailored SYSRES pack that includes a full batch supervisor, an 
interactive supervisor, and an ICAM network; adding a supervisor to a tailored SYSRES 
pack; duplicating an existing supervisor on a new release of OS/3; generating an NTR 
utility; and configuring processing option values for the ANSI'74 COBOL compiler. 


9.2. CREATING A BASIC SUPERVISOR ON THE OS/3 RELEASE VOLUME 


This example illustrates the parameter statements necessary to generate a basic 
supervisor onto the OS/3 release volume. 


AOPERATIONA 










SUPGEN 


SUPVRNAM=SYSBAS 

JOBSLOTS=2 TIMER=MAX PRIORITY=2 
COMM=1,12 FLOATPT=YES 

END 


T/OGEN 
COP 
PRINTER 
READER 
PUNCH 
DISC 
END 

// FIN 


TYPE=8418 ADDR=00~-03 


The SUPGEN section defines a basic supervisor designed for small main storage 
machines. It supports two job slots and communications. 


The |I/OGEN section identifies each I/O device configured in the system: one console 
printer; one printer, reader, and punch all with default specifications; and a disk of type 
8418 at an address that is not the default address. 
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9.3. CREATING A TAILORED SYSRES PACK FOR A BATCH SYSTEM & 


This example generates a tailored SYSRES pack that includes a full batch supervisor 
(SY$ALL) and an ICAM network. 


LABEL AOPERATIONA 

SUPGEN 
SUPVRNAM=SYSALL PRIORITY=5 JOBSLOTS=7 
DMGTMODE=MIXED 
TRANS=2 TIMER=MAX COMM=1, 12 
FLOATPT=YES FILELOCK=YES 
RESMOD=SM$TASK , SM$STIXT, SMSLOD 
RESMOD=SM$GTPUT, SMSATCH, SMSLOCK 
SPOOL ING=OUTPUT 


END 
1/OGEN 
cop 
PRINTER TYPE=0770 
PRINTER TYPE=0768 
READER TYPE=07 16 
PUNCH TYPE=0604 
DISC TYPE=8414 ADDR=40-42 
DISC TYPE=8418 ADDR=00-03 & 
DISC TYPE=8430 ADDR=10-12 
TAPE 
TAPE TYPE=20 ADDR=20-22 
TAPE TYPE=6 ADDR=00-02 
DISKETTE ADDR=00-03 
END 
RESGEN 
SYSOUT=DSP001, 8430 
DELETE=COBL74, DMS, IVP 
CDIMODE=YES COS=2 
END 
COMMCT 
NET1 CCA TYPE=(STDMCP) , PASSWORKD=JHB, FEATURES=(OPCOM, OUTDELV) 
- BUFFERS 25,100,1,ARP=63 
LNE1 LINE DEVICE=(UNISCOPE), TYPE=(2000,SWCH,SYNC), x 
CALL=555-2726, INPUT=PRC1 
TRM1 TERM  — ADDR=(28,51), FEATURES=(U400, 1920), x 
LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
PRC1 PRCS | LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
ENDCCA 
NET2 CCA TYPE=(DDI,3) 


BUFFERS ARP=24 


(continued) . 
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LABEL AOPERATIONA 


LINE DEVICE=(UNISCOPE) , TYPE=(2600,SWCH,SYNC), X 

CALL=555-2728 

TERM ADDR=(28,51) , FEATURES=(U400, 1920), X 
AUX1=(TCS,73,74) ,AUX3=(TCS, 75,76) 

ENDCCA 3 

CCA USERS=2 

ENDCCA 

MCP | 

MCPNAME=M9 

MCPVOL=SYSRES 

CACH=(04,NET1,01) 

CACH=(06,300, SWITCHED) 

CACH=(08, 2000, SWITCHED, SYNC) 

CACH=(10,300, SWITCHED) 

CACH=(12,2000, SWITCHED, SYNC) 

CACH=( 13,9600, SWITCHED, SYNC) 

CACH=(14, 2000, SWITCHED, SYNC) 





The SUPGEN section defines a full batch supervisor (SY$ALL) with both CDI and DTF 
data management support. This system sacrifices main storage for throughput by 
specifying commonly used system routines as resident (RESMOD), by allowing seven 
job slots, and by configuring output spooling. 


The 1/OGEN section identifies each |/O device in the system: a console printer; a type 
0770 printer, type 0768 printer, and a type 0716 reader, all with default specifications; 
three different type of disks with specific addresses; one tape device with all default 
specifications and a type 20 and type 6 tape with specific addresses; and a type 8413 
diskette with all default specifications. 


The RESGEN section specifies that a tailored 8430 SYSRES volume is created with this 
user's volume, DSPOO1. The system deletes COBL74, DMS, and IVP modules and uses 
CDI data management modules. 


The COMMCT section defines an ICAM network. 
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9.4. CREATING A TAILORED SYSRES PACK FOR AN INTERACTIVE SYSTEM 


This example generates a tailored SYSRES pack that includes an interactive supervisor 
(SY$IAC) and an ICAM network. 


LABEL AOPERATIONA 
SUPGEN 
SUPVRNAM=SYSIAC 
JOBSLOTS=7 TRAN=4 
COMM=2, 24 PRIORITY=5 
SPOOL ING=INPUT JOBACCT=YES 
INTERACTIVE=YES ISBATCHLMT=3 
END 
1/OGEN 
CoP 
PRINTER TYPE=0770 
PRINTER TYPE=0768 
READER TYPE=0716 
PUNCH TYPE=0604 
DISC TYPE=8414 ADDR=40-42 
DISC TYPE=8418 ADDR=00-03 
DISC TYPE=8430 ADDR=10-12 
TAPE 
TAPE TYPE=20 ADDR=20-22 
TAPE TYPE=6 ADDR=-0-02 
DISKETTE ADDR=00-03 
WORKSTATION ADDR=18-18 
END 
RESGEN 
SYSOUT=DSP001, 8430 
DELETE=COBL74, DMS, IVP 
CDIMODE=YES COS=2 
END 
COMMCT 
NET1 CCA TYPE=(STDMCP) , PASSWORKD=JHB, FEATURES=(OPCOM, OUTDELV) 
BUFFERS 25,100,1,ARP=63 
LNE1 LINE DEVICE=(UNISCOPE) , TYPE=(2000,SWCH,SYNC), X 
CALL=555-2726, INPUT=PRC1 
TRM1 TERM ADDR=(28,51) , FEATURES=(U400, 1920), x 
LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN | 
PRC1 PRCS LOW=MAIN, MEDIUM=MAIN, HIGH=MAIN 
ENDCCA 
NET2 CCA TYPE=(DDI,3) 
BUFFERS  ARP=24 
LNE1 LINE DEVICE=(UNISCOPE) , TYPE=(2000, SWCH, SYNC), X 


CALL=555-2728 


(continued) 
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LABEL —_—s| AOPERATIONA 





TRM1 | TERM ADDR=(28,51), FEATURES=(U400, 1920), X 
AUX1=(TCS ,73,74) , AUX3=(TCS,75, 76) 


| | ENDCCA ~ | 
PIOCS == | CCA — USERS=2 
a | ENDCCA 
| cP 
_ MCPNAME=M9 
MCPVOL=SYSRES 
| CACH=(04,NET1,01) — 
CACH=(06,300, SWITCHED) 
- CACH=(08, 2000, SWITCHED, SYNC). 
- CACH=(10,300,SWITCHED) 
CACH=(12, 2000, SWITCHED, SYNC) 
CACH=( 13,9600, SWITCHED, SYNC) 
CACH=( 14,2000, SWITCHED, SYNC) 


This SUPGEN section detnes an interactive supervisor (SY$IAC) that has spoofing and 
interactivity for both local workstations and remote terminals through interactive 
services (INTERACTIVE= YES). | 


The !/OGEN section is identical to that of the batch supervisor in example 9.3 with the 
exception. that the interactive |/O configuration includes workstation specifications. (You 
cannot specify workstations without specifying interactivity during SUPGEN; therefore, 
you cannot use the \OMOD parameter to specify the batch supervisor's 1/O 
configuration.) : 


The RESGEN section specifies that a tailored 8430 SYSRES volume is created with this 
user's volume, DSPOO1. The system deletes COBL 74, DMS, and IVP modules and uses 
CDI modules. 


The COMMCT section defines the same network for this interactive supervisor as for 
the batch supervisor in example 9.3. 
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9.5. ADDING A SUPERVISOR TO YOUR TAILORED SYSRES PACK 


The following example adds a supervisor to this user’s previously generated SYSRES. 





AOPERATIONA 
SUPGEN 
SUPVRNAM=SYSNRM 

PRIORITY=5 JOBSLOTS=/7 TRANS=2 T IMER=MAX 
SPOOL ING=INPUT 

END 
I/OGEN 
IT /OMOD=SYSBAS 
END 
RESGEN 
SYSOUT=DSP001,8430,NOPREP 
END 
//FIN 


The SUPGEN section defines a typical supervisor configuration. 


The 1/OGEN section calls for the I/O configuration used in the previously generated 
supervisor, SY$BAS, which resides on $SYSSRC on this user’s release volume. 


The RESGEN section directs the supervisor be placed on the previously generated 


SYSRES volume, DSPOO1. 


9.6. DUPLICATING AN EXISTING SUPERVISOR ON A NEW OS/3 RELEASE 
VOLUME | | | 


In this example, this user duplicates the existing supervisor from the current SYSRES 
onto the new OS/3REL volume. 





AOPERATIONA 





SUPGEN 





SUPMOD=SYSBAS 
SUPVRNAM=SYSTST 
END 
I/OGEN 
I /OMOD=SYSBAS 
END 
//FIN 


Both the SUPGEN and I/OGEN sections call for the configurations in the previously 
generated supervisor, SY$BAS, which resides on $Y$SRC of SYSRES. 


If this user includes a RESGEN section, the new supervisor would be placed on the 
volume named on the SYSOUT parameter. 
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9.7. GENERATING AN NTR UTILITY 


This example generates a nine-thousand-remote (NTR) system utility and its supporting 
ICAM network. 







AOPERATIONA 
NTRGEN 


NTR 
NTRNAME=NTRO1 BLOCKIN=24® BLOCKOUT=121 
NTRVOL=COMRES 
LINESP=20 NET=NTR2 LINE=LNE1 SITE=903001 
TASK=NTRTK3,@ TASK=NTRTK4,O 
LOCAL 
TASKNAME=TSK1 BLKSIZE=80 DEVICE=1 
FUNCD=01 LFD=RDR TYPE=READER 
LOCAL 
TASKNAME=TSK2 BLKSIZE=84 DEVICE=2 
LFD=PUNCH TYPE=PUNCH 
LOCAL 
TASKNAME=TSK3 BLKSIZE=134 DEVICE=3 
LFD=PRNTR TYPE=PRINTER 
VFBLEN=72 VFBDEN=6 VFBHOME=1 
VEBFORM=11@OHDR 
END 
COMMCT 
NTR2 CCA TYPE=(NTR), FEATURES=( TRACEMAX) 
BUFFERS ARP=50 
LNE1 LINE DEVICE=(NTR), TYPE=(2000,FULL,SWCH,SYNC, CONNECT), x 
RETRY=(10, 10), TIMEOUT=(15,8) 
TRM1 TERM FEATURES=(NTR) 
ENDCCA 
MCP 
MCPNAME=C9 
MCPVOL=COMRES 
CACH=(12,NTR2,01) 
END 
// FIN 


In the NTR section, three sets of local keywords specify a reader, punch, and printer. 
The TASK parameter identifies two previously generated NTR remote device handlers. 


In the COMMCT section, one CCA specifies an NTR mode and one line terminal. The 
MICP load module name is C9 and is used to load the generated MCP from the SYSRES 
volume. The one physical CA port, 12, will match the characteristics of the first line of 
CCA NTR2, which is LNE 1. 


Both the MCP load module and the NTR utility module will reside on the SYSRES 
volume named COMRES. 
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9.8. CONFIGURING ANSI‘'74 COBOL COMPILER PROCESSING OPTION VALUES 


The following illustration shows the statements needed to configure processing option 
values for the ANSI'74 COBOL compiler different from the standard option defaults. 





AOPERATIONA 







COBGEN 
AXREF=YES 





MAP=YES 
MXREF=YES 
OBJLST=YES 
END 
// FIN 


In the COBGEN section, this user changes the COBOL default parameters to specify: 

= an alphabetically ordered cross-reference listing; 

= an object program locator/map listing; 

@ a cross-reference listing; and 

@ an object program listing. 

This user can override any of these new defaults using PARAM statements in the 


compilation job control stream. The OS/3 ANSI '74 COBOL programmer reference, 
UP-8613 (current version) lists the standard defaults. 
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10. SYSGEN Operating Procedures 


10.1. GENERAL 


This section gives the operating procedures for performing a SYSGEN. It includes the 
following steps: 


Paragraph 

= Copying the OS/3 release tape to the OS/3 release volume (OS/3REL) 10.2 
m @§=Installing separately delivered OS/3 products 10.3 
m= Making backup copies of the OS/3REL and SYSRES volumes 10.4 
= Choosing an operating supervisor 10.5 
w Defining print band characteristics (for nonstandard print cartridges) 10.6 
m= SYSGEN procedures 10.7 

1. Preparation of SYSGEN parameter statements 

2. System initialization 

3. Parameter processor execution 

4. SYSGEN jobstream execution 
m Post-SYSGEN procedures 10.8 


The system commands needed to perform all of these operating procedures can be 
keyed in at the system console or from a workstation. If operating from a console, you 
will receive messages concerning both your jobs and those of every other job being 
executed in your system. If operating from a workstation, you will receive system 
messages concerning only your jobs. 
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System messages are divided into two types: 


1. Standard operating procedures messages, which we present in the system 
messages manual, UP-8076 (current version). 


2. SYSGEN messages, which are self-explanatory, informational messages for the 
console or workstation user. 


This manual presents examples of typical system messages that you receive when you 
run the SYSGEN JOB streams as part of the job stream execution procedures in 10.7. 
10.2. COPYING THE OS/3 RELEASE TAPE TO THE OS/3REL VOLUME 

If your OS/3 release software is on a dump/restore tape, you must copy the software 
from the tape onto a disk before you can go on to SYSGEN. That disk then serves as 
your OS/3REL volume and can be used as input for SYSGEN. To copy your release 
software from tape to disk, mount the release tape and the disk that will serve as your 
OS/3REL volume and proceed as follows: 

NOTE: 

To perform this procedure, we assume that your SYSRES is mounted and that your 
system is operating under the control of either a starter supervisor that we delivered or 
one that you've generated yourself. 

1. Key in RV SGSDMPTD and press the XMIT key. 

2. When SGSDMPTD requests IS THE INPUT TAPE MULTI-VOLUME (N, Y): 


a. Respond with N if you received your software on one tape or Y if you received 
your software on two tapes. 


b. Press the XMIT key. 
3. When SGSDMPTD requests ENTER VSN OF INPUT TAPE: 


a. Key in the VSN identified on the tape label. If you received your release on two 
tapes, key in the VSN of the first tape. 


b. Press the XMIT key. 

4. When SGSDMPTD requests ENTER VSN OF INPUT TAPE2: 
a. Key in the VSN identified on the second tape. 
b. Press the XMIT key. 


NOTE: 


This request appears only if you specified multi-volume input in step 2. 


UP-8074 Rev. 11 SPERRY UNIVAC OS/3 | 10-3 
SYSTEM INSTALLATION Update A 


5. When SGSDMPTD requests ENTER VSN OF OUTPUT DISK: 
a. Key in the VSN of the disk that will serve as your OS/3 REL volume. 
b. Press the XMIT key. 
6. When SGSDMPTD requests IS THE OUTPUT DISK A FIXED HEAD DEVICE (N,Y): 


a. Key in Y if the OS/3REL volume has the fixed head feature; otherwise, key in 
N. 


b. Press the XMIT key. 


When SGSDMPTD terminates, both the standard and optional software have been 
installed on your OS/3 REL volume. 


10.3. INSTALLING SEPARATELY DELIVERED, OPTIONAL OS/3 PRODUCTS 


Sperry Univac delivers optional software products that you order between major OS/3 
releases on tape or disk, according to how you order them. The job control stream, 
SGSCPYPD, lets you install these products from either type of media. And it is capable 
of installing one or several products in one execution. 


To install optional program products or programming aids, proceed as follows: 
NOTE: 


To perform this procedure, we assume that your SYSRES is mounted and that your 
system is operating under the control of either a starter supervisor that we delivered or 
one that you've generated yourself. 


1. Key in RVASG$CPYPD. 
2. Press the XMIT key. 


3. When SG$CPYPD displays the message IS INPUT FROM TAPE (T) OR DISK(D)?, 
key in T if the product ts on tape; key in D if it is on disk. 


4. Press the XMIT key. 


5. When SGSCPYPD displays the message MOUNT VOL=A_ GO?, mount the tape or 
disk that contains your separate products. 


6. Key in GOASGSCPYPD and press the XMIT key. SG$CPYPD then initiates the 
routine, SGSMVPD, that moves the separate products from the release media to 
your SYSRES. When SG$CPYPD successfully copies your optional products to your 
SYSRES, it displays a message to inform you that the routine terminated normally. 
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7. If the optional product(s) that you installed requires operating system support, be 
sure to generate system modules that support that product before you attempt to 
use it. Table 10-1 lists all the optional products that OS/3 offers, and it indicates 
which SYSGEN phases you must perform (or reperform, if need be) to use these 
optional products. To use a specific program product or programming aid, each of 
the seven SYSGEN phases is either: required (R), not required (NR), or optional (O). 


For example, if you just installed the NTR program product, you must perform the 
NTR phase of SYSGEN. And you must perform (or reperform, if need be) the ICAM, 
SUPGEN, and I/OGEN phases. You are required to include no other phases in your 
SYSGEN operation to support that product. 


The manuals in the OS/3 library that concern separate, optional components give 
specific SYSGEN requirements for those products if, in fact, any specific requirements 
exist. 


Table 10—1. SYSGEWN Phases for Optional Software (Part 1 of 3) 


OS/3 SYSGEN Phases 


_surcen’|rocen’ | rescen| emurar| commet| wracen | coscen_ 


PROGRAM PRODUCTS 





Extended System Software 
(ESS) 
Data Utility 
SORT /MERGE 
SORT3 
Spool/JA/Syslog 
/Joblog 


SORT /MERGE 
SORT3 


Screen Format Generator 

Dialog Spec. Language Translator 
Menu Generator 

iIMS-ST** 


IMS-MT** 
DMS 


RPG Group 
RPGII 
RPGEDIT (CDM) 
RPG Auto Report 


COBOL-68 Basic (DTF) 
COBOL-68 Extended (DTF) 
COBOL-74 

COBOL Editor 


FORTRAN IV 
FORTRAN Basic (DTF) 
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@ Table 10—1. SYSGEN Phases for Optional Software (Part 2 of 3) 


OS/3 SYSGEN Phases 


| suPGEN:| 10GEN: | RESGEN EMULAT | COMMCT]| NTRGEN | COBGEN 
NR NR NR NR NR NR NR 


OS/3 Optional Products 








BASIC (CDM) 
ESCORT (CDM) NR 
EDITOR (CDM) NR 
ASSEMBLER NR 
ICAM TSF R 
NTR R 
DCA Termination System R 
IBM 3270 RTH R 
IBM 3270 Emulator R 
RTP (HASP) Facility R 
DATEX-L PDN Support R 
DATEX-P R 
& TRANSPAC R 
DATA PAC R 
DDX-P R 
PSS PDN R 
DDP Transfer Facility R 
DDP File Access R 
DDP IMS R 
Transaction Processor 
BEM Monitor (DTF) NR 
BEM EDT (DTF) NR 
BEM BASIC (DTF) NR 
BEM RSP (DTF) NR 
UTS 400 COBOL and R 
LD/DMP Terminal Package 
UTS 400 EDIT Processor and R 


LD/DMP Terminal Package 


PROGRAMMING AIDS 





System Activity Monitor R R NR NR NR NR NR 
UTS 400 Software (DTF) R R NR NR R NR NR 
PL/M R R NR NR R NR NR 
SMS400 R R NR NR R NR NR 
MAC80 R R NR NR R NR NR 
Utilities R R NR NR R NR NR 
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Table 10—-1. SYSGEN Phases for Optional Software (Part 3 of 3) 


OS/3 SYSGEN Phases 


| supcen:| 10Gen: | RESGEN EMULAT | COMMCT] NTRGEN | COBGEN 
NR NR NR NR NR NR NR 


OS/3 Optional Products 





Gangpunch/Reproduce (DTF) 





VSBs (DTF) 
FORTRAN Extended (DTF) 


System/3 Conversion Aids 
SCON3 Srce and Proc 
Trans (1) 
COPYS3 Srce and Proc 
Trans 


System/34 Conversion Aids 
COPY 3 Srce and Proc 
Trans 


360/20 Conversion Aids (DTF) 

Unioad Data 
Transcriber (2) 

Reload Data Transcriber 

scan BAL Source 
Converter 

360/20 Emulator 

DCON 20 Proc for 
Unload and Reload (3) 


OS/4 Conversion Aids 
DCON4 Disk Data 
Conv (4) 
ASMTRN Assembly 
Trans 
JCON 1 JCL Conv 
COPY 94 Lib File Conv 


92/9300 Conversion Aids 
(DTF) 

Unload Data 
Transcriber (5) 

Reload Data Transcriber 

9200/9300 Emulator 

Scan BAL Source 
Converter 


On-line Diagnostics 


* Note that anytime you install a product that affects your supervisor, you must peform SUPGEN and !OGEN, even 
though you did not add any new 1|/O devices to your system. 


** If you have installed IMS, you must configure your IMS as a post-SYSGEN procedure. To do so, see the IMS system 
support functions user guide, UP-8364 (current version). 


LEGEND: 


NR 


Not required 


R 


I 


Required 


O = Optional 
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10.4. MAKING BACKUP COPIES OF THE OS/3REL AND SYSRES VOLUMES 


Sperry Univac recommends that you make a backup copy of your OS/3 release volume 
before you begin SYSGEN. We also recommend that you make a backup copy of your 
tailored SYSRES after SYSGEN. Sperry Univac supplies job control streams 
(SETREL/COPYREL and DCOP) as part of the OS/3 release software to make your 
backup copies. When choosing one of these job control streams, keep the following 
tradeoff in mind: 


~ SETREL/COPYREL allows you to copy your release or SYSRES volume to any 
disk type but requires more time to execute; 


— DCOP requires less execution time but allows you to copy your release or 
SYSRES volume to the same disk type only. 


The subsections that follow (10.4.1 and 10.4.2) describe the procedures for making 
backup copies. | 
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10.4.1. Using SETREL/COPYREL to Copy to Any Disk Type 


10.4.1.1. Performing SETREL 


The SETREL system utility prepares a disk volume for use as a RELEASE or SYSRES 
volume. This utility executes a disk initialization (prep) run and allocates the standard 
SYSRES files. The library size is allocated according to the type of volume required. 
Disks may be initialized with or without full surface analysis. The required parameters 
are supplied either as operands entered by keyins at the system console or workstation, 
on cards in the card reader, or on card images on diskette. 


NOTE: 


SETREL preps the disk pack with 1K COS. If 2K COS is required, you must run the 
canned job control stream PRP2KCOS immediately after running SETREL. This also 
applies to installations requiring 2K fast COS, in which case PRP3KCOS would be run. 
The procedure for running PRPnn COS is described in 10.4. 1.2. 


When the disk being prepared is to be a copy of the current SYSRES volume, a keyin at 
the system console or workstation may be used to initiate a SETREL run. 


The keyin has the following format: 
RUASETREL, , V=vsn, T=disk-type,P=prep- type 
Keyword Parameters: 
V=vsn 
Specifies the volume serial number of the output disk pack being prepped. If 


omitted, the card reader is activated to read the parameters from cards. 


T=disk-type 
Specifies the type of disk subsystem being used. The values are as follows: 





Value Disk Type 

11 8411 

14 8414 

15F 8415 fixed 

15R 8415 removable 

16 8416 

18 8418 high and low density 
24 7 8424 

25 8425 

30 8430 


33 8433 
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P=prep-type 
Specifies the type of prep to be performed. The codes may be: 


Code Meaning 





F Full prep (surface analysis) 
P Partial prep (no surface analysis) 
N No prep performed, assign files only 


lf codes are omitted, P is assumed. 


When you omit the V keyword parameter, your parameters are read from the assigned 
system reader. In this case, the volume copy will be a release volume and the following 
statements must precede the disk prep parameter set (if present): 


// PREP JSET 'prep-number'! 
// VSNO JSET 'vsn'! 

// TYPE JSET 'disk-type' 
// FIN 


These parameters are described previously with the exception of ‘prep-number’: 


‘1° Full prep (surface analysis) 


‘O’ Partial prep (no surface analysis) 


If you specify a full prep, you must insert one of the following statement sets in the 
assigned system reader: 


INSERT cccchh 


// FIN 


where: 


ccecchh 


Specifies the hexadecimal address of the defective cylinder and track 


as listed on the disk pack. Use this statement set only if you wish to 
identify additional alternate tracks. 


INSERT NONE 
// FIN 


where: 


NONE 


Indicates that you want to specify no further defective cylinders or 
tracks on the disk pack. (Omit the INSERTA A ANONE statement for 
selector devices and use the second // FIN statement instead.) 
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oe 


© If unrecoverable errors occur during the prepping of a volume, you receive a message at 
your console or workstation and the job terminates immediately. If other errors occur, 
you receive a warning message and the job continues processing. 


10.4.1.2. Performing PRPnnCOS 


The PRPnnCOS routine repositions the COS module from the $Y$SRC file on SYSRES to 
the COS-IPL area on a disk you specify. The value you give for nn (1K, 2K, 3K) 
indicates the type of COS module to be repositioned. PRPnnCOS repositions the COS 
module from $Y$SRC to an area immediately following the VOL1 label on the disk; from 
this position, it can then be loaded into the system. This routine must be run before 
you try to load your COS module into the system, after SETREL, and before COPYREL. 


The required parameters are supplied either as operands entered at the system console 
or workstation, on cards in the card reader, or on card images on diskette. 


When you are performing PRPnnCOS to make a copy of your current SYSRES, the keyin 
has one of the following formats: 


PRP2KCOS 


RVA(PRP1KCOS) , ,V=vsn, T=disk-type 
PRP3KCOS 





Keyword Parameters: 


V=vsn 
Specifies the volume serial number of the disk being prepared with COS. 


T=disk-type 
Specifies the type of disk subsystem being used. The values are as follows: 





Value Disk Type 

11 8411 

14 8414 

15F 8415 fixed 

15R 8415 removable 
16 8416 

18A 8418 low density 
18B 8418 high density 
24 8424 

25 8425 

30 8430 


33 8433 
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You may alternatively specify these keyword parameters on cards in the card reader, or 
card images on diskette. To perform PRPnnCOS to make a copy of your release volume, 
specify the keyword parameters using the following format: 


// VSN JSET ‘vsn! 
// TYPE JSET 'disk-type' 
// FIN 


The keyword parameters are described previously. 


10.4.1.3. Performing COPYREL 


The COPYREL system utility copies the RELEASE or SYSRES volume libraries listed in 
Table 10-2 to a second disk pack of any type. The capability provides a convenient 
mechanism for duplicating the libraries for backup purposes or for restoring SYSRES 
volumes between dissimilar devices. The new disk pack must be prepped and the files 
allocated (via SETREL) before they can be copied. The required parameters are supplied 
either as operands entered at the system console or workstation, on cards in the card 
reader, or on card images on diskette. 


When you are performing COPYREL to copy your current SYSRES volume, COPYREL 
may be run using a keyin at the system console or workstation. The keyin has the 
following format: 


RVACOPYREL,[,V=vsn][,T=disk-type][,S=first-file][,E=last-file] 


Keyword Parameters: 


V=vsn 
Specifies the volume serial number of the output disk pack. If omitted, the 
parameters must be input from cards. 


T=disk-type 
Specifies the type of disk subsystem being used. The values are: 





Value Disk Type 

11 8411 

14 8414 

15F 8415 fixed 

15R 8415 removable 
16 8416 

18A 8418 low density 
18B 8418 high density 
24 8424 

25 8425 

30 8430 

33 8433 


If the V parameter is specified, this parameter must also be specified. 
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S=first-file 
Specifies the code for the first file to be copied. Table 10-2 shows the order 
that COPYREL copies the system files and shows the codes for each system 
file. If omitted, copying begins with S. 


E=last-file 
Specifies the code for the last file to be copied. (See Table 10-2). If omitted, 
copying ends with A. 


The S and E keyword parameters are used to control the number of files to be copied. 
They can also be used to restart the COPYREL function with the library in which an 
error occurred or to restore a single library. For example: 


RVACOPYREL, , V=ABC123, T=16, S=G, E=A 
RVACOPYREL, , V=ABC123, T=16,S=L,E=L 


Table 10-2. COPYREL Copy Order 


SYSSRC 
SYSOBJ 
$YSLOD 
SYSMAC 
SYSJCS 
SGSJCS 
SGSMAC 
SGSOBJ 
SGSLOD 
SYSSCLOD 
SYSMIC 
IVPLIB 


SMCFILE 
FMT 
SAVE 
DIALOG 
SDF 
HELP 

T 

A 





SMCFILE 
SYSFMT 
SYSSAVE 
SYSDIALOG 
SYSSDF 
SYSHELP 
SYSTRAN 
SYSTRANA 
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When you omit the V keyword parameter, your parameters are read from the assigned & 
system reader. In this case, the volume copy will be a release volume and the following 

statements must be in the reader: 

NOTE: 


Cards 1, 2, 3, 4, and 7 are required. 





1 10 16 72 
1. | //INVOL JSET ‘input-vsn! x 
2. | //INTYPE JSET 'input-type' 
5. | //OUTVOL JSET ‘output-vsn' 
4. | //OUTTYPE JSET ‘output-type! 
9. | //S JSET 'first-file' 
6.) //E JSET ‘Last-file' 
7. | // FIN 
where: 
‘'input-vsn' 
Specifies the volume serial number of the input disk pack. 
'input-type' 





Specifies the type of disk subsystem containing the volume being copied. The @ 
values are supplied in the preceding value-disk type table. 


‘output-vsn' 
Specifies the volume serial number of the output disk pack. 


lf running COPYREL for an 8415 removable disk, the utility must be run twice. 
For the first run, the // OUTVOL card is replaced with a // VSN1 card 
Specifying the volume serial number of the primary disk. For the second run, 
the card is changed to // VSN2 and the volume serial number of the 
secondary disk is entered. 


'output-type' 
Specifies the type of disk subsystem to which the files are being copied. The 
values are the same as those specified for ‘input-type’. 


'first-file' 
Specifies the first file to be copied. The code letters that may be specified are: 


S, 0, L, M, J, G, T, or A 


The order the files are copied for card processing is the same as for console 
or workstation keyin. 

















UP-8074 Rev. 11 SPERRY UNIVAC OS/3 10-13 
SYSTEM INSTALLATION - Update A 


‘'Last-file' 
Specifies the last file to be copied. The code letters that may be specified are: 


5, O, L, M, J, G, T, or A 


The order the files are copied for card processing is the same as for console 
or workstation keyin. 


10.4.2. Using DCOP to Copy to the Same Disk Type 


You can copy your SYSRES disk pack to another disk of the same type by keying in the 
following command at the system console or workstation. 


RVADCOP io d 


where: 





T=disk-type 
Specifies the type of disk subsystem being used. The values are: 


Value Disk Type 

11 8411 

14 8414 

15F 8415 fixed 

15R 8415 removable 
16 8416 

18A 8418 low density 
18B 8418 high density 
30 8430 

53 8433 


lf omitted, the 8416 device is assumed. 


N=number 


Specifies the number of copies to be made. This is a decimal value from 1 to 
7. If omitted, one copy is assumed. 


V=fYES 


“Specifies that verification is to be performed on the copied disks. If omitted, 
no verification is performed. 


When the message MOUNT DEV=did VSN=DISC GO? appears, check that did Is the 
device address of the disk you are copying your SYSRES to, key in GOADCOP, and 
press the XMIT key. DCOP then copies the entire contents of your SYSRES, including 
the VSN, to the backup disk. If you don’t want two disks with the same VSN, use the 
CGV canned job stream as explained in the system service programs user guide, 
UP-8062 (current version). When it completes the copy operation, DCOP displays a 
message to inform you that it has terminated normally. 
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10.5. CHOOSING AN OPERATING SUPERVISOR 


Regardless of whether you are an existing user or a user who is installing the OS/3 
Operating system for the first time, you must select an operating supervisor from the 
OS/3REL volume supplied to your facility. Choose a supervisor that supports your 
hardware configuration. Use the list contained in the release notice that accompanies the 
OS/3REL to aid you in this selection. 


A new user must also define print cartridge characteristics tf all of your printers use 
nonstandard print cartridges. This procedure is described in 10.6. The standard 
cartridges are: 


m 48-BUS (except 0768 printer) 
mw 48-SCI (except 0768 printer) 


# 63-STD (0768 printer only) 


10.6. DEFINING PRINT BAND CHARACTERISTICS 


lf your printers use nonstandard print cartridges, you must define them to the starter 
supervisor by running job control stream SG$PRB, which is prefiled on the OS/3REL 
volume. In addition, if your installation uses only nonstandard length printer forms (other 
than 11 inches), you should define their vertical format characteristics. We recommend 
that you define your printer requirements at this time for all your printers using 
nonstandard print bands and/or nonstandard vertical formats. 


SG$PRB accepts the job control statements that define nonstandard printer 
characteristics either from card input or from a source module you create in $Y$SRC on 
your SYSRES. You can create this source module in two ways: 


1. Use the OS/3 general editor (EDT) to prepare the statements and then write them 
to a module in $Y$SRC. 


2. Use the system librarian (LIBS) to add the statements from cards to a module in 
SYSSRC (use the ELE statement to do this). 


Regardless of the method you use to create input to SGSPRB, refer to the job control 
user guide, UP-8065 (current version) for instructions on preparing the // LCB and 
// VFB job control statements that define your printer characteristics. To prepare these 
statements, proceed as follows: 
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NOTE: 


To perform this procedure, initialize the system by loading control storage and IPL the 
starter supervisor into main storage as described in the operations handbook for 
operators, UP-8072 (current version). 


1. Keypunch or key in from a workstation a // DVC job control statement for each 
printer for which you are defining print band and/or vertical format characteristics. 
You can submit one // DVC statement for both a // LCB and a // VFB statement, 
but if you are defining more than one print band or vertical format buffer for one 
printer, you must prepare a // DVC statement for each LCB-VFB set you define. 
Each // DVC statement and its associated // LCB and // VFB statements must be 
prepared separately. That is, you must include only one // DVC statement and one 
// LCB and/or // VFB statement in each card deck or source module you submit as 
input to SGSPRB. On each // DVC statement: 


m @ Identify the printer type by specifying the logical unit number (Table 3-1). 


@ $Specify the hardware address so that the physical printer and not a virtual one 
is accessed at SG$PRB scheduling time when running under the control of a 
supervisor configured with spooling. (If you do not specify the hardware 
address, the content of the default LCB/VFB is not changed by a spooling 
supervisor.) 


2. Keypunch or key in from a workstation a // LCB job control statement for each 
print configuration you are defining for each printer. 


m Specify user load code buffer OWNLC1 or OWNLC2 in the label field to specify 
that your printer uses a print band other than 48—BUS, 48—SCI, or 63-—STD; if 
you want to specify character mismatch reporting for only one of these print 
bands, specify the name of your print band in the label field. 


= Define your printer band configuration. (Refer to the job control user guide, 
UP-—8065 (current version) for format.) 


NOTE: 


lf you have an 0773/0778 printer with a nonstandard print band (that is, if 
your print band is greater than 64 characters in length), you must define a load 
code buffer 256 characters in length. The character array may be repeated until 
256 bytes are defined. If your print band ts 64 characters or less, you must 
define a load code buffer 64 characters in length. 


3. Keypunch or key in from a workstation a // VFB job control statement for each 
printer if required. 


= Specify vertical format buffer OWNVF1 in the label field. 


= Specify FORMNAME=STAND1 as the form name parameter. 
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m= =ODefine the remainder of your vertical format requirements. (Refer to the job 
control user guide, UP-8065 (current version) for format.) 


4. Keypunch a // FIN job control statement if you are entering input to SG$PRB on 
cards. Enter the // DVC, // LCB, and // VFB job control statements, in that order. 
Follow the last statement with the // FIN statement. If you used EDT or LIBS to 
create a module in $Y$SRC containing these statements, skip this step and 
proceed with step 5. But be sure to include the MOD parameter on your run 
command. 


5. Run the SG$PRB job control stream (to load the appropriate LCBs and VFBs with 
the new definitions) by keying in the following system command: 


RVASGSPRB[, ,MOD=module name] 


where: 


MOD=module name 
Specifies the module in $Y$SRC that contains the nonstandard printer 
characteristics. If you do not specify this parameter, you must enter input 
to SGSPRB on cards. 


6. When SG$PRB terminates, reload the starter supervisor. @ 


Example 1. Changing VFB characteristics: 


EDT 

1.90000 // DVC 20,330 

2.0000 //OWNVF1 VFB FORMNAME=STAND1,DEN=8,LEN=88, OVF=80 
3.90060 @WRITE MO=VFBCHG, FIL=$Y$SRC, VSN=RELO80 

4.9000 @HALT 


RV SGSPRB, ,MOD=VFBCHG 


In this example, we've created a source module with the general editor (EDT) to 
alter VFB printer characteristics. The // DVC statement shows the logical unit 
number (20) and the hardware address (330) of the printer. The // VFB statement 
must contain OWNVF1 in the label field and STAND1 as the formname. We've 
used a standard 11-inch form and specified a density (DEN) of 8 lines per inch, thus 
giving the form a length (LEN) of 88 lines. We've also specified overflow (OVF) at 

line 80. Printing will stop at line 80 and continue at the top of the next form. 
leaving a 1-inch margin at the bottom of each form. 


We issue the @WRITE command to name the source module and write it in 
SY$SRC on our SYSRES volume (VSN=RELO80O): then we terminate EDT with the 
@HALT command. After creating the source module, we run SG$PRB using the 
module name specified in the @WRITE statement (VFBCHG). SG$PRB displays a 
message when it terminates. 
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® Example 2. Changing LCB characteristics: 


EDT 

1.0000 // DVC 20,330 

2.0000 //48-BUS LCB MISM=REPORT 

3.9000 @WRITE MO=LCBCHG,FIL=$Y$SRC, VSN=RELO80 
4.0000 @HALT 


RV SGSPRB, ,MOD=LCBCHG 


In this example, we've used EDT to create a source module to alter LCB printer 
characteristics. The // DVC statement shows the logical unit number (20) and the 
hardware address (330) of the printer. The LCB statement contains the cartridge 
name in the label field (48—BUS) and specifies that character mismatch errors will 
be reported. 


We issue the @WRITE command to name the source module and write it in 
SY$SRC on our SYSRES volume; then, we terminate EDT with the @HALT 
command. After creating the source module, we run SG$PRB using the module 
name specified in the @WRITE statement (L.CBCHG). SG$PRB displays a message 
when it terminates. 
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10.7. SYSGEN PROCEDURES 

The SYSGEN procedures consist of four basic steps: 

1. Preparing the SYSGEN parameter set containing your configuration specificaticns 
2. Initializing your system and mounting the required disk packs 


3. Running the parameter processor (SGBPARAM) to process your SYSGEN parameter 
sets 


4. Running the prefiled SYSGEN job control streams that configure your system 


You now have the option of performing these four SYSGEN steps in one of two system 
environments: (1) a batch environment, in which OS/3 has traditionally operated, and (2) 
an interactive environment. 


A system in a batch environment uses input entered on cards from a card reader or 
from card images on diskette in a cardless system. This manual outlines the procedure 
for generating a batch system with card input in 10.7.1. 


To install a cardless system, use the CREATE diskette utility described in the system 
service programs user guide, UP-8062 (current version) or the enter mode described in 
the universal distributed system (UDS) 2000 manual, UP-8503 (current version). 


A system in an interactive environment recognizes input from either a workstation or a 
remote communications terminal using an interactive facility of OS/3 called the SYSGEN 
dialog. This manual describes the procedure for generating an interactive system in 
10.7.2. 


10.7.1. Generating in a Batch System 


10.7.1.1. Step 1 — Preparing the SYSGEN Parameter Deck 
To prepare the SYSGEN parameter deck, proceed as follows: 


1. Determine the SYSGEN phase or phases you want included in this generation 
procedure. (Refer to guidelines outlined in 1.4.1.) As we stated earlier, this manual 
specifically describes the SYSGEN procedure. It does not, however, describe in 
detail all of the components of OS/3. Therefore, before you begin to prepare your 
SYSGEN parameters, familiarize yourself with the components in your system by 
referencing the specific manuals in the OS/3 library that apply to those 
components. 
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Keypunch the parameter specifications for each phase you want included in this 
SYSGEN. Each phase must be properly identified by a leading label card and trailing 
card. (See Table 10-3 for phase requirements.) 


Follow the SYSGEN parameter deck with a // FIN card. 


Table 10-3. SYSGEN Phase Requirements 


Generation Requirement Phases Required | Parameter Descriptions 


New supervisor SUPGEN Section 2 
and/or !/O and Section 3 
configuration I/OGEN 


Emulator generation EMULAT Section 5 


Communications COMMCT Section 6 
module generation 


NTR system utility NTRGEN Section 7 
module generation and Section 6 
COMMCT 


ANSI'74 COBOL processing | COBGEN Section 8 
option default changes 


New SYSRES volume RESGEN Section 4 
generation 





10.7.1.2. Step 2 — Initializing Your System 


The procedure for initializing your system is determined by the method used to integrate 
the generated output into your system. (Subsection 1.4.2 outlines the various methods 
of integrating system software into a new installation, upgrading existing systems to a 
new release level, and regenerating system software or adding additional system 
software at the same release level.) 


1. 


Mount the current OS/3REL volume on the proper disk drive unit. This volume 
serves as both the operating system and the source volume and is required for all 
methods of system software integration into your system. 


Initilize your system by loading control storage (COS) and a starter supervisor from 
OS/3REL into main storage as described in the operations handbook for operators, 
UP—8072 (current version). 

NOTE: 


For 90/30 B, you cannot perform a IPL from a selector channel disk. 


lf SYSGEN output is to be placed on a disk pack other than the OS/3REL volume, 
mount a new output disk pack. 
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10.7.1.3. Step 3 — Running the Parameter Processor 

To process your SYSGEN parameter deck, proceed as follows: 

1. Enter your SYSGEN parameter deck into the system reader. 

2. Key in the following system command to initiate the parameter processor: 


RUASGSPARAM 


The following example shows typical system messages that you receive when you run 
the SYSGEN job stream, SG$PARAM. 


RU SGSPARAM 

11 JC@1 JOB SGSPARAM EXECUTING JOB STEP SGCNFGOO #001 
12 JC@8 USING DEV=002 TYPE=PRNTR 

135 JC@2 JOB SGSPARAM TERMINATED NORMALLY 


The parameter processor translates and verifies the SYSGEN parameters and lists the 
SYSGEN job control streams to be executed. 


NOTE: 
If the OS/3REL volume is provided on an 8415 removable disk pack, it will consist of 


three volumes: primary, secondary, and tertiary. Each volume supports only specific 
phases of the total SYSGEN procedure: 


m@ Primary volume = SUPGEN 
I/OGEN 
RESGEN 


@ Secondary volume = COBGEN 
COMMCT 


g ‘Tertiary volume = NTRGEN 
EMULAT 


An alternate command must be used to initiate the parameter processor for the 
secondary or tertiary volume if any one of these phases is included in this SYSGEN 
procedure. Key in the following system command if the secondary volume is used: 


RUASGSPARAM, , ALT=YES 


Key in the following system command if the tertiary volume is used: 


RUASGSPARAM, , OTH=YES 





UP-8074 Rev. 11 SPERRY UNIVAC OS/3 10-20 
SYSTEM INSTALLATION Update B 


3. Check output listing prepared by the parameter processor for diagnostic messages. 
Also, carefully check the SGSPARAM listing to be sure that all of SGBPARAM’s 
default substitutions are correct for the type of system you are generating. 


4. Correct any SYSGEN parameter card found to be in error and rerun the parameter 
processor (repeat steps 1 through 3). 


5. Execute the prefiled job control stream (10.7.1.4) listed in the output listing. 


10.7.1.4. Step 4 — Running the Prefiled SYSGEN Job Streams 


The actual generation function is accomplished by running the SYSGEN job control 
streams listed on the parameter processor output report. (The job streams listed are 
selected on the basis of your configuration deck.) The job streams are to be run one at 
a time in the order that they are listed. You must wait until each job is completed 
before executing the next job in the sequence. 


The names and functions of each prefiled job control stream that can appear in the 
output list are provided in 1.3.1. 


NOTE: 


Do not rerun SG$PARAM until all the jobs listed in the output list have been run; 
otherwise, the variables generated by the first execution of SG$PARAM will be lost and 


you will be able to run only the jobs listed for the current (second) execution of 
SGSPARAM. 


10.7.1.5. Creating a New SYSRES Volume 


The following job control streams should be listed for execution when you have 
included the RESGEN phase in your SYSGEN parameter deck. 


SG$PREP 

SG$ASG 

SG$TRANS 

SG$LIB 

SGSSUPMK 
SG$LIB2 (only for 8415 release volumes) 
SG$LIB3 (only for 8415 release volumes) 
SGS$CATCP (if catalog copy is desired) 


Proceed as follows to execute job control streams listed: 


1. Execute the SG$PREP job control stream from the current release pack by keying in 
the following system command: 


RUASGSPREP, [,CR=NO] 
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where: 


CR=NO 
Specifies that you're running SGSPREP from the system console and your 


system does not have a card reader. The job stream then requests the 
prep parameters through the console. 


The following example shows typical system messages that you receive when you 
run the SYSGEN job stream, SG$SPREP. 


SGSPREP (2) (3) (4) (5) (6) (7) 
JC@6 USING DEV=301 VSN=SYSRES 

JC@8 USING DEV=FLE TYPE=ENTER 

C01 JOB SGSPREP EXECUTING JOB STEP DSKPRP@91001 15:10:37 
KEY IN RV SGSASG TO RUN NEXT SYSGEN JOB 


NOTE: 


When executed, SG$PREP activates the card reader or requests card image input 
for the purpose of obtaining information concerning ‘“‘bad’’ tracks as indicated by 
the manufacturer on SPERRY UNIVAC 8415, 8416, and 8418 disk packs or for 
specific requests for 8411/8414/8430 and 8433 disks. These bad tracks must be 
identified by an INSERT statement (one track per statement) and the set must be 
terminated with a // FIN statement. If you are using an 8415, 8416, or 8418 disk 
pack containing no bad tracks, you must place an INSERT statement with the word 
NONE starting in column 10, followed by a // FIN statement in the reader to satisfy 
the card or card image input request made by SG$PREP. Messages at the system 
console request this information as your system needs it if you included the CR 
parameter on your run command. 


2. Execute the SGSASG job stream by keying in the following system command: 


RVASGSASG 


The following example shows typical system messages that you receive when you — 
run the SYSGEN job stream, SGSASG. 


SGSASG (2) (3) (4) (3) (6) (7) 
JC98 USING DEV=902 TYPE=PRNTR 

JC1® USING DEV=441 VSN=XXXXXX 

JC@1 JOB SGSACG EXECUTING JOB STEP SGSOPNOO #0062 
KEY IN RV SGSTRANS TO RUN NEXT SYSGEN JOB 

JC@2 JOBSGSASG TERMINATED NORMALLY 


If the job terminates abnormally, you must rerun SG$PREP and then rerun SGSASG. 
You can save approximately 15 minutes in processing time by specifying the 
PARTIAL prep option in the SYSOUT keyword of your RESGEN configuration and 
rerunning the SG$PARAM job control stream. 


The message displayed on the system console or workstation screen will indicate 
when you can execute the next job control stream. 
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3. Execute the following job control streams one at a time by keying in the following 
system commands: 


RVASGSTRANS 
RVASGSLIB 
RVASGSSUPMK[, , TPWK=vsn] 


where: 
TPWK=vsn 
Provides temporary work files for the assembler on an alternate disk 
device. VSN identifies the volume serial number of the alternate device. 
NOTE: 


When the OS/3REL is also your current SYSRES, do not run SG$TRANS in a 
multiprogramming environment. Otherwise, you may encounter errors. 


The following examples show typical system messages that you receive when you 
run the SYSGEN job streams, SGSTRANS, SG$LIB, and SG$SUPMK. 


SGSTRANS (2) (3) (4) (5) (6) (7) 
JC@1 JOB SGSTRANS EXECUTING JOB STEP SGTRANO® #001 

JC@6 USING DEV=441 VSN=XXXXXX 

JC98 USING DEV=002 TYPE=PRNTR 

JC@1 JOB SGSTRANS EXECUTING JOB STEP SGTRANO® #002 

JC®@6 USING DEV=441 VSN=XXXXXX 

KEY IN RV SGS$LIB TO RUN NEXT SYSGEN JOB 

JC@2 JOB SGSTRANS TERMINATED NORMALLY 


SGSLIB (2) (3) (4) (5) (6) (7) 
JC@1 JOB SG$LIB EXECUTING JOB STEP LIBSO000 #001 

JC@6 USING DEV=441 VSN=XXXXXX 

JC@8 USING DEV=@002 TYPE=PRNTR 

KEY IN RV SGSSUPMK TO RUN NEXT SYSGEN JOB 

JC@2 JOB SG$LIB TERMINATED NORMALLY 


SGSSUPMK (2) (3) (4) (5) (6) (7) 
JC@1 JOB SGSSUPMK EXECUTING JOB:STEP ASM@0000 #001 
JC@6 USING DEV=441 VSN=XXXXXX 

JC®@8 USING DEV=002 TYPE=PRNTR 

JC@1 JOB SGSSUPMK EXECUTING JOB STEP LNKEDT@@O #002 
JC@2 JOB SGSSUPMK TERMINATED NORMALLY 


If any of these jobs terminates abnormally, rerun it before proceeding. 
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4. This step applies only to 8415 secondary and tertiary release volumes. It copies 
the remainder of the system components from the secondary and tertiary release 
volume to complete the system. 


lf there are no other disk drives available, dismount the 8415 primary release 
volume and replace it with the secondary release volume. Initialize your system 
from the SYSRES just created. See the operations handbook for operators, 
UP-—8072 (current version). 


Execute SG$LIB2 job control stream by keying in the following system command: 


RVASGSLIB2 


After SG$LIB2 has finished, replace the secondary release volume with the tertiary 
release volume and initialize your system in the manner described above. Then, key 
in the following system command: 


RVASGSLIB3 


If either job terminates abnormally, rerun it. 


5. If you want to copy an existing catalog file to your new SYSRES volume, you must 
have specified the volume serial number of the disk that contains the catalog file 
using the CATVSN keyword parameter in the RESGEN section. 


Execute SG$CATCP job control stream by keying in the following system 
command: 


RVASGSCATCP 


lf this job terminates abnormally, rerun it. 


6. Additional job control streams such as SGSEMUMK, SGSEMJCL, SGSCOMMK, 
SGSNTRMK, and SGSCOBMK may also be listed if you included the parameters for 
these phases in your SYSGEN parameter set. If they are listed in the output listing, 
execute them as described in 10.7.1.7 through 10.7.1.10. 
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10.7.1.6. Supervisor Generation without Creating a New SYSRES 

If you included a supervisor generation phase as part of your SYSGEN set but did not 
specify the creation of a new SYSRES pack, the job control stream SGSSUPMK will be 
listed in the output listing. Execute this job stream by keying in the following system 
command: 


RVASGSSUPMK[, , TPWK=vsn] 


where: 
TPWK=vsn 
Provides temporary work files for the assembler on an alternate disk device. 
VSN identifies the volume serial number of the alternate device. 
The supervisor generated is placed on the OS/3REL volume. (You may designate that 
the supervisor be placed on an alternate SYSRES volume by including a RESGEN phase 
in the SGSPARAM run in which the keyword parameter SYSOUT=vsn,,NOPREP is 
specified.) 
10.7.1.7. Emulator Generation 


Execute the emulator generation job control stream SGS$EMUMK by keying in the 
following system command: | 


RVASGSEMUMK 


The emulator load module generated is placed on the OS/3REL volume. (There is an 
optional specification in the emulator descriptor statements that allows you to designate 
an alternate output volume.) 


To keypunch the job control stream to execute the generated emulator, execute the 
SG$SEMJCL job control stream by keying in the following system command 


RVASGSEMJCL 


10.7.1.8. ICAM Generation 


Execute the ICAM generation job control stream SGSCOMMK by keying in the following 


system command: 


RVASGSCOMMK[,[, GENLST=Y][, TPWK=vsn]] 


where: 


GENLST = Y 
Specifies that you want a complete listing of the |CAM macro generations. 
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TPWK=vsn 
Provides temporary work files for the assembler on an alternate disk 
device. VSN identifies the volume serial number of the alternate device. 


The generated communications load module is written to the OS/3REL volume. (There is 
an optional parameter, MCPVOL, in the COMMCT section that allows you to designate 
an alternate output volume.) 


10.7.1.9. NTR Generation 


Execute the NTR generation job control stream SG$NTRMK by keying in the following 
system command: 


RVASGSNTRMK 


The NTR load module generated is placed on the OS/3REL volume. (There is an optional 
parameter in the NTR section that allows you to designate an alternate output volume.) 


10.7.1.10. ANSI'74 COBOL Processing Option Value Generation 


Execute the ANSI '74 COBOL option value generation job control stream SGSCOBMK by 
keying in the following system command: 


RVASGSCOBMK 


The processing option values are placed on the OS/3REL volume unless a RESGEN 
phase is included in the SYSGEN parameter set to specify an alternate output volume. 


NOTE: 


To change values specified by an earlier COBGEN, you must specify every default that 
differs from the COBOL standard defaults, not the first COBGEN. If, for example, you 
specify AXREF=YES in the first COBGEN and want to keep that default, you must 
specify it in the second COBGEN, or else it will revert to the standard default of 
AXREF =NO. 


10.7.2. Generating in an Interactive System 


As a user with one or more workstations, you will want to take advantage of the 
interactive facility of OS/3 called the SYSGEN dialog. This facility helps you to prepare 
and process your SYSGEN parameter sets directly at a workstation or a remote 
communications terminal. This manual describes the SYSGEN dialog in 1.3.2. 
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10.7.2.1. Step 1 — Initializing Your System 


The procedure for initializing your system is determined by the method used to integrate 
the generated output into your system. (Subsection 1.4.2 outlines the various methods 
of integrating system software into a new installation, upgrading existing systems to a 
new release level, and regenerating system software or adding additional system 
software at the same release level.) 


1. Mount the OS/3REL volume on the proper disk drive unit. This volume serves as 
the operating system and source volume and is required for all methods of system 
software integration into your system. 


2. Initialize your system by loading control storage (COS) and a starter supervisor from 
OS/3REL into main storage as described in the operations handbook for operators, 
UP-8072 (current version). 


NOTE: 
For 90/30 B, you cannot IPL from a selector channel disk. 


3. If SYSGEN output is to be placed on a disk pack other than the OS/3REL volume, 
mount a new output disk pack. 


10.7.2.2. Step 2 — Preparing the SYSGEN Parameter Set 


The following paragraphs describe the procedure for preparing your SYSGEN parameter 
sets using the SYSGEN dialog. Sperry Univac supplies the SYSGEN dialog to enable you 
to prepare your parameter sets as easily as possible in an interactive environment. If, 
for any reason, you prefer to prepare your SYSGEN parameter sets without the aid of 
the SYSGEN dialog, you can prepare them using the interactive facility, the general 
editor. We describe the use of the general editor in the general editor user 
guide/programmer reference, UP-8828 (current version). However, because the SYSGEN 
dialog minimizes the risk of interactive users preparing invalid parameter sets, we 
recommend that only the most experienced SYSGEN users use the general editor. If you 
prepare your sets using the general editor, you must process them using the procedure 
for manual execution of the parameter processor, which we present in 10.7.2.3.2. 


NOTES: 


1. Before performing the following procedure using the SYSGEN dialog, we 
recommend that you read through it thoroughly, learn the type of information the 
system will expect you to provide in response to its requests, and only then 
proceed to follow this procedure one step after another. If you terminate the 
SYSGEN dialog prematurely (using the F4 key), extraneous messages may be 
generated. 


2. Before executing the SYSGEN dialog, you must create the file that will hold the 
audit file version of your dialog session. To create that file, follow the instructions 
in the job control user guide/programmer reference, UP-8065 (current version). 
Specifically, you must include the EXT job control statement in your job control 
stream to allocate a file that is two cylinders in size. 


S 
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To prepare your parameter sets using the SYSGEN dialog, proceed as follows: 


i 


Determine the SYSGEN phase or phases you want included in this generation 
procedure. Refer to the guildelines outlined in 1.4.1. As we stated earlier, this 
manual specifically describes the SYSGEN procedure. It does not, however, 
describe in detail all of the components of OS/3. Therefore, before you begin to 
prepare your SYSGEN parameters, familiarize yourself with the components in your 
system by referencing the specific manuals in the OS/3 library that apply to those 
components. | 


At your workstation, enter workstation mode by simultaneously pressing the 
FUNCTION key and the workstation mode key (WS MODE). Your system then 
displays the OS/3 LOGON request screen, which looks like this: 


000000 S255 / 333 
00000000 SSSSSS$ 4/ s3530 
00 00 $$ S$ 44h 33 33 
00 00 $$ 444 33 
00 00 35 444 33 
O00 00 SS 441 333 
O00 00 S$ | 33 
00 00 S$ SS ssh 33 33 
00000000 SSSSSS$ // 3333333 

000000 SS$S$$ / 3333 


SPERRY UNIVAC INTERACTIVE OPERATING SYSTEM 
DEPRESS TRANSMIT FOR LOGON 


|_—___________ 


When you see the LOGON request screen, press the XMIT key. Your system then 
displays the LOGON menu screen, which looks like this: 











OS/3 INTERACTIVE SERVICES 


LOGON IDENTIFICATION: USER-1D 4 >. 
ACCOUNT NUMBER Su. 
PASSWORD 









OPTIONS: EXECUTION PROFILE > < 


BULLETIN PLES <= 
LOG 
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4. When you see the LOGON menu screen, press the XMIT key if you are an initial 
user; if you are an existing user operating under a supervisor that includes 
interactive security, fill in the menu screen as the interactive services commands 
and facilities user guide/programmer reference, UP-8845 (current version) 
describes. Either action causes your system to display messages informing you that 
it accepted your logon and to display the system bulletin. 


5. Enter system mode by simultaneously pressing the FUNCTION key and the system 
mode key (SYS MODE). 


NOTE: 


lf you are performing this procedure at a remote communications terminal, be sure 
the terminal contains the field-protect feature; otherwise, you will encounter errors. 


6. Execute the SYSGEN dialog by keying in: 


RVASGSBLD 


7. Press the XMIT key. This response causes the dialog to display a short paragraph 
explaining RUN libraries. 


8. When you've read the paragraph on RUN libraries, press the XMIT key. The dialog 
will then request if you want to save a RUN library. 


9. When the message DO YOU WANT TO SAVE RUN LIBRARY? (Y OR N) appears, 
key in N. 


10. Press the XMIT key. When you see the message ARE YOU CREATING A NEW 
AUDIT FILE (Y/N)?, key in Y for yes. 


11. Press the XMIT key. When you see the message ENTER VSN OF DISC 
CONTAINING NEW AUDIT FILE — _ — _ _ — , keyin the volume serial number of 
your SYSRES disk. 


12. Press the XMIT key. When you see the message ENTER FILE LABEL OF NEW 
AUDIT FILE — _ _ _ _ _ _ , key in the file label (LBL) of the file that you 
previously created to hold the audit file version of your dialog session. 


13. Press the XMIT key. When you see the message, ARE YOU AUDITING AN OLD 
AUDIT FILE? (Y/N), key in N for no. 


14. Press the XMIT key. The dialog then displays the message, DIALOG PROCESSOR 
READY, to inform you that it is ready to help you prepare your SYSGEN 
parameters. Then, it requests what type of system you are using. 


15. When you see the message WHAT SYSTEM ARE YOU GENERATING?, key in 1 for 
series 90. 
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Press the XMIT key. The dialog then displays a short definition of the SYSGEN 
dialog. 


When you see the’ paragraph titled PROGRAM=DIALOG FOR SYSTEM 
GENERATION, key in HELP and press the XMIT key. The dialog then displays a 
description of the dialog method for preparing SYSGEN parameters. 


After you've read the description of the dialog method, press the XMIT key. The 
dialog then displays its master menu screen. Through the master menu screen, you 
can choose the SYSGEN phases that you need to generate. 


When you see the master menu screen, which we show here, choose one of the 


selections in the following manner to prepare sets for all the SYSGEN phases that 
you must perform: 


SELECT THE SYSGEN PHASE TO BE PREPARED: 


SUPERVISOR GENERATION (SUPGEN and IOGEN) 
ICAM MODULE GENERATION (COMMCT) 

COBOL COMPILER OPTIONS SPECS (COBGEN) 

NTR UTILITY GENERATION (NTRGEN) 

SYSTEM RESIDENT VOLUME CREATION CRESGEN) 


NO FURTHER PHASE REQUIREMENTS 
DISPLAY PHASE DESCRIPTIONS 

(ENTER NUMBER FOR SINGLE PHASE OR 
''HELP'' FOR ALL PHASES) 


ENTER CHOICE BY NUMBER 





Key in 1 and press the XMIT key to perform the SUPGEN and IOGEN phases, 
which enable you to prepare all of the necessary parameters for generating a 
supervisor module and defining your hardware configuration to OS/3. If you key in 
response 1, the SYSGEN dialog displays screens requesting which services and 
facilities you want in your supervisor. Next, it displays menu screens enabling you 
to define your hardware configuration to OS/3. When specifying these devices, you 
do not have to define all devices in the same category at the same time. For 
example, you may define the disk device containing your SYSRES volume first, 
followed by your printers, workstations, and other disk devices. In fact, we 
recommend that you define each I/O device in the order of most frequent use to 
reduce |/O access time during later processing. | 


When it requires no other information from you, the dialog redisplays its master 
menu screen. 
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Key in response 2 and press the XMIT key to perform the COMMCT phase, 
through which you prepare all the necessary parameters for generating an ICAM 
symbiont. If you respond with 2, the SYSGEN dialog displays only those messages 
concerning COMMCT, then redisplays its master menu screen. 


Key in response 3 and press the XMIT key to perform the COBGEN phase, which 
enables you to generate processing options for the ANS! °74 COBOL compiler 
different from the compiler’s standard default optins. If you key in 3, the dialog 
displays only those screens that pertain to the COBGEN phase and then redisplays 
the master menu screen. 


Key in response 4 and press the XMIT key to perform the NTRGEN phase, through 
which you prepare the necessary parameters for generating an NTR module in your 
system. If you respond with 4, the dialog displays only those messages concerning 
NTRGEN, then redisplays its master menu screen. 


Key in response 5 and press the XMIT key to perform the RESGEN phase, which 
enables you to place your SYSGEN output on a disk other than the OS/3REL 
volume. If you respond with 5, the dialog displays only those screens that pertain 
to RESGEN, then redisplays its master menu screen. 


Key in response 6 and press the XMIT key to inform the dialog that you have no 
other control modules for which you must prepare parameter sets, and that the 
current dialog session is complete. If you key in response 6, proceed to step 21. 


Key in response 7 and press the XMIT key to read descriptions of each of the 
SYSGEN phases. After it displays these phase descriptions, the dialog redisplays its 
master menu screen. 


After you respond to the master menu screen, the SYSGEN dialog guides you 
step-by-step in specifying SYSGEN parameter sets for the phases that you indicate. 
As you proceed through the dialog, press the XMIT key to go on to subsequent 
screens. If you need more information about a parameter, request help by keying in 
the choice that gives a HELP screen or by keying in HELP in the space provided. If 
a parameter does not concern you, simply press the TAB FORWARD key to ignore 
it and your system automatically provides a sufficient default value for you. Then, 
when you reach the bottom of the screen, press the XMIT key. (When specifying 
your hardware configuration to OS/3, be sure to specify a device category 
parameter and a type parameter for each device, whether you want to accept the 
default values for that device or not. Otherwise, OS/3 generates your supervisor 
without an |/O configuration for that device.) 


While specifying some parameters, you may need to use the SYSGEN parameter 
reference tables in the sections on the SYSGEN phases. These tables give you 
guidelines and formulas for specifying particular SYSGEN parameters. Each time you 
complete the parameter specifications for a single phase, the dialog redisplays its 
master menu screen until you respond to it with choice 6. 
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To omit a parameter from your sets while using the dialog, you must replace the 
enter-field for that parameter with either underlines or spaces. For parameters that 
have only numeric values, you must use spaces since the underline character is not 
a numeric character and will be rejected by the system. On ICAM terminals, use a 
destructive space bar by putting (SP/DS) in the last field on the control page. 


When you key in response 6 to inform the dialog that you've completed your 
session, the SYSGEN dialog displays the message DIALOG SESSION TERMINATED 
NORMALLY. Press the XMIT key. The dialog then displays a message requesting if 
you want it to execute the parameter processor. 


When the message DO YOU WANT TO EXECUTE THE PARAMETER PROCESSOR 
AGAINST DIALOG OUTPUT? (Y OR N) appears, key in Y and press the XMIT key if 
you want to proceed with the SYSGEN process; if you want to review your 
parameter sets or, because of time limits, you do not want to execute the 
parameter processor, key in N and press the XMIT key. Either response causes the 
dialog to display a message (step 23) asking you where you want your dialog 
output stored. 


When the message ENTER A 1-8 CHARACTER NAME FOR THIS OUTPUT 
MODULE appears, press the XMIT key if you want the dialog to store your 
parameter sets as a module named SG$INPUT on $Y$SRC; if another dialog 
parameter set already exists with the module name SG$INPUT and you want to 
keep that set, key in an alternate 1-8 character name for your new module and 
press the XMIT key. 


NOTE: 


After responding to step 23, your next action depends on your response to step 
22. If you keyed in Y to step 22, go to 10.7.2.3.1 for automatic execution of the 
parameter processor. If you keyed in N to step 22, the dialog stores your sets 
under the module name that you specified in step 23 and then terminates. In this 
case, proceed to 10.7.2.3.2 for manual execution of the parameter processor. 


10.7.2.3. Step 3 — Running the Parameter Processor 


This subsection presents the procedures for processing your SYSGEN sets either by 
automatically or manually executing the parameter processor (SGSPARAM). Which 
method you use depends, primarily, on how you prepared your sets. 


lf, at the end of your dialog session, you want the dialog to execute the parameter 
processor against your dialog session output, use the procedure for automatic execution 
of the parameter processor in 10.7.2.3.1. 


On the other hand, you must manually execute the parameter processor, using the 
procedure in 10.7.2.3.2, for any of the following reasons: 





At the end of your dialog session, you wanted to review all your parameter sets to 
ensure that they are correct or, because of time limits, you did not want to execute 
the parameter processor. 
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= Your parameter sets are in one of the following forms: 
— as parameters prepared using the general editor; 
— as source modules created interactively and saved from a previous release; or 


— aS parameters output from a previous dialog session and corrected by the 
general editor. 


NOTE: 


Never rerun SG$PARAM until you run all the jobs listed by SGSPARAM,; otherwise, the 
variables generated by the first execution of SGSPARAM will be lost and you will be 
able to run only the jobs listed for the current (second) execution of SGfPARAM. 


10.7.2.3.1. Automatic Execution of the Parameter Processor 


Your system prepares to execute the parameter processor automatically when you 
answer Y (for yes) to the dialog’s request DO YOU WANT TO EXECUTE THE 
PARAMETER PROCESSOR AGAINST DIALOG OUTPUT? (Y OR N). Then, after you 
inform your system of where to store the dialog output by responding to the message 
ENTER A 1-8 CHARACTER NAME FOR THIS OUTPUT MODULE, the dialog: 


m stores your sets; 

= automatically executes the parameter processor; 

m™ supplies it with the parameter sets that you just created; 
@ ~=prints a summary listing of your entire dialog session; and 
= terminates normally. 


The parameter processor then processes and verifies your SYSGEN parameter values. It 
provides a complete listing of all your parameter values, defaults, errors in your sets, 


and the execution sequence of the job control streams that you must execute if it finds 
no errors. 


lf the processor terminates normally and finds no errors in your sets, carefully check the 
SG$PARAM listing to be sure that all its default substitutions are correct for your 
situation and the type of system you are generating. Then, proceed to the procedure for 
running the SYSGEN job control streams in 10.7.2.4. If the processor finds errors in 
your sets, it also displays a message on your screen informing you of the number of 
errors in your sets. 


When this message appears, you must correct or change your parameter sets using the 
parameter processor output listing as a guide to identifying the errors. To correct or 
change parameters, use the audit capability of the SYSGEN dialog which we describe 
here. The audit capability lets you easily correct parameters that you prepared using the 
dialog and that reside in the audit file you allocated to contain them. 














UP-8074 Rev. 11 SPERRY UNIVAC OS/3 10-33 
SYSTEM INSTALLATION 


Or you can use the general editor to correct or change parameters. The general editor is 
a general purpose editor that lets you edit, change, or correct the contents of any 
module in your system. To use the editor, see the general editor user 
guide/programmer reference, UP-8828 (current version). When using the editor, specify 
the name of the source module containing your dialog output as the module that you 
want to edit. After you correct your parameter sets, go to step 1 of the procedure for 
manually executing the parameter processor. To use the audit file capability of the 
SYSGEN dialog, perform the following steps: 


1. Create the file that will hold the new audit file version of your dialog session. To 
create that file, follow the instructions in the job control user guide/programmer 
reference, UP-8065 (current version). Specifically, you must include the EXT job 
control statement in your job control stream to allocate a file 2 cylinders in size. 


2. Reexecute the SYSGEN dialog starting at step 6 of the procedure for preparing your 
parameter sets. 


3. When you see the message ARE YOU CREATING A NEW AUDIT FILE? (Y/N), key 
~ In_Y for yes. 


4. Press the XMIT key. When you see the message, ENTER VSN OF DISC 
CONTAINING NEW AUDIT FILE - - - -- - , key in the volume serial number of 
your SYSRES disk. 


5. Press the XMIT key. When you see the message ENTER FILE LABEL OF OLD 
AUDIT FILE - - --- - , key in a different file label name than the file containing 
the audit version of the dialog session during which you prepared your parameter 
sets. In other words, provide a name for your new audit file different from the 
name you gave your old audit file. 


6. Press the XMIT key. When you see the message ARE YOU AUDITING AN OLD 
AUDIT FILE?(Y/N), key in Y for yes. | 


7. Press the XMIT key. When you see the message, ENTER VSN OF DISC 
CONTAINING OLD AUDIT FILE - ----- , key in the volume serial number of 
your SYSRES disk. 


8. Press the XMIT key. When you see the message ENTER FILE LABEL OF OLD 
AUDIT FILE - ---- - , key in the file label name of the file containing the audit 
version of the dialog session during which you prepared your parameter sets. 


9. Press the XMIT key. The dialog then displays a message that it is ready to help 
you audit your old audit file. Then it requests which paragraphs you want to 
change. Use the summary listing that the dialog provided at the end of the dialog 
session as a guide to the paragraphs you want to change. The paragraphs are 
numbered sequentially to act as a map to your audit file. 
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NOTES: 


1. 


lf you need to make changes to the paragraph containing the SYSGEN dialog 
master menu screen, you must re-create the dialog entirely. In that case, go 
back to the procedure for preparing your SYSGEN parameter sets (10. 7.2.2) 


At the end of the upcoming dialog audit session, the dialog either automatically 
executes the SYSGEN parameter processor or terminates. Which action takes 
place depends on the response that your new audit file contains to the dialog 
question DO YOU WANT TO EXECUTE THE PARAMETER PROCESSOR? If you 
do not change the paragraph containing that response, the dialog uses the 
same response that both your old and new audit file contain; if you change 
that response in the upcoming audit session, the dialog uses the response that 
your new audit file will contain after this session. Therefore, according to what 
you want the dialog to do at the end of this session, decide if you want to 
change the paragraph containing that response. If you do, specify it in step 10. 


10. When you see the following screen, key in the paragraph numbers of the 
paragraphs that you want to change or correct. | 


11. 


12. 


DP10®@ OS/3DIALOG PROCESSOR VERSION 
ENTER PARAGRAPH NUMBERS TO BE EDITED. 
PARAGRAPH NUMBERS MUST BE IN ASCENDING ORDER 


WITH ONLY ONE NUMBER IN EACH AREA. 





Press the XMIT key. The dialog then displays each of the paragraphs you indicated 
you want to change, one at a time. 


Correct all the paragraphs you want to change according to the following 
instructions: : 


d. 


When the dialog displays a paragraph, the top of the screen shows what your 
old audit file contains for that paragraph. The middle of the screen is blank and 
the bottom of the screen displays your auditing options at the beginning of a 
paragraph. For example, in step 10, you tell the dialog that you want to 
change paragraph 8 of your old audit file. In this example, paragraph 8 contains 


part of the SUPGEN parameters. The dialog would show you a screen 


resembling this one: 


UP-8074 Rev. 11 





SPERRY UNIVAC OS/3 10-35 
SYSTEM INSTALLATION 


SUPERVISOR SIZING PARAMETERS 

1. PRIORITY TASK PRIORITY LEVELS 

2. JOBSLOTS NUMBER OF JOBSLOTS 

3. TRANS NUMBER OF TRANSIENT AREAS 

4. SHAREDMGT SHARED DATA MNGMENT TABLE SLOTS 
5. SYMBPRI SYMBIONT PRIORITY LEVEL 

FOR HELP ENTER PARAMETER NUMBER OR 'ALL' 


AT THE BEGINNING OF PARAGRAPH, YOU CAN: 
ENDSESSION (F4), EDIT (F7), OR PROCEED (XMIT) 





At this point, choose one of the following auditing options by pressing the 
FUNCTION key and simultaneously pressing the workstation function key that 
corresponds to it: 


ENDSESSION (F4) — This option lets you normally terminate an auditing 
session before you've made all your changes to the old audit file. If you 
choose ENDSESSION, the dialog displays a message informing you that it 
terminated normally, but your new audit file is incomplete and must not be 
used. When you subsequently want to complete the auditing session, you 
must perform this procedure over again starting at step 1 and specify the 
same name for the old audit file that you did in this session. 


EDIT (F7) — This option lets you make changes and corrections to the 
paragraph that you are working on. In most cases, you will choose EDIT 
at this point because you told the dialog that you want to change this 
paragraph in step 10. If you choose EDIT, go to step b. 


PROCEED (XMIT) — This option lets you go on to the next paragraph you 
indicated in step 10, without making any changes to the current 
paragraph. You choose PROCEED at this point only if, after rereading the 
paragraph, you realize you don’t want to change it, but you had indicated 
so in step 10. If you choose PROCEED, go back to step a. 
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b. When you tell the dialog that you want to EDIT a paragraph, the top of the @ 
screen again shows your old audit file, the middle of the screen is reserved for 
your changes, and the bottom of the screen shows your auditing options at a 
choice point in a paragraph. Using our same example, the dialog shows a 
screen resembling this one: | 


SUPERVISOR SIZING PARAMETERS 

1 PRIORITY TASK PRIORITY LEVELS 

2. JOBSLOTS NUMBER OF JOBSLOTS 

3. TRANS NUMBER OF TRANSIENT AREAS 

4 SHAREDMGT SHARED DATA MNGMENT TABLE SLOTS 
> 


- SYMBPRI SYMBIONT PRIORITY LEVEL 
FOR HELP, ENTER PARAMETER NUMBER OR ‘ALL’ 


AT CHOICE POINT IN PARAGRAPH, YOU CAN: 
CANCEL (F2), REEDIT (F3), ENDSESSION (F4), & 
INSERT (F5), DELETE (F6), EDIT (F7), OR PROCEED (XMIT) 





At this point, choose only one of the following auditing options by pressing 
the FUNCTION key and simultaneously pressing the workstation function key — 
that corresponds to it: 


— CANCEL (F2) — This option is invalid at this point. 
— REEDIT (F3) — This option is invalid at this point. 
— ENDSESSION (F4) -— See explanation under step a. 


— INSERT (F5) — This option lets you insert a choice that you neglected to 
specify in the paragraph during your original dialog session. If you choose 
INSERT, the dialog displays the paragraph and positions the cursor at the 
first data field. To skip to the next data field without inserting a value at 
the current field, press the TAB FORWARD key. After you finish all the 
data fields, go to step c. 





— DELETE (F6) — This option lets you delete a choice that you specified in 
the paragraph during the original dialog session. If you choose DELETE, 
the dialog displays the paragraph, deletes the first data field, then } 
positions the cursor at the next data field. To delete the value, press F6 
again; to the next data field without deleting the current value, press the 
TAB FORWARD key. After you finish all the data fields, go to step c. 
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& — EDIT (F7) — This option lets you edit, or change, a value that you specified 
in the paragraph during the original dialog session. If you choose EDIT, the 
dialog displays the old audit file screen for that paragraph and positions 
the cursor at the first data field. Press the TAB FORWARD key to position 
the cursor at the data field that you want to change, key in the correct 
value over the incorrect the value, and press the XMIT key. After you edit 
the data fields, go to step c. 


c. After you perform the auditing option at the choice point in the paragraph, the 
top of the screen shows your old audit file, the middle of the screen shows 
your new audit file, and the bottom of the screen shows your auditing options 
at the end of the paragraph. Using our same example, assume we chose to 
edit paragraph 8 to change the number of jobslots from 3 to 7. The dialog 
shows you a screen resembling this one: 










SUPERVISOR SIZING PARAMETERS 








1. PRIORITY TASK PRIORITY LEVELS Y) 
2. JOBSLOTS NUMBER OF JOBSLOTS 5 
3. TRANS NUMBER OF TRANSIENT AREAS 4, 
4. SHAREDMGT SHARED DATA MNGMENT TABLE SLOTS 5 
>. SYMBPRI SYMBIONT PRIORITY LEVEL 6 





FOR HELP, ENTER PARAMETER NUMBER OR 'ALL' 



















1 PRIORITY TASK PRIORITY LEVELS ") 
2. JOBSLOTS NUMBER OF JOBSLOTS re 
3. TRANS NUMBER OF TRANSIENT AREAS 4 
4 SHAREDMGT SHARED DATA MNGMENT TABLE SLOTS > 
> SYMBPRI SYMBIONT PRIORITY LEVEL 6 








AT END OF PARAGRAPH, YOU CAN: 
CANCEL (F2), REEDIT (F353), ENDSESSION (F4), OR PROCEED (XMIT) 


At this point, choose one of the following auditing options: 


— CANCEL (F2) — This option lets you cancel the changes you made to the 
paragraph in step b. Choose this function if you made many changes that 
you now want to cancel. lf you choose CANCEL, go back to step a. 


—  REEDIT (F3) — This option lets you reedit the paragraph that you audited in 
step b. Choose this option if you made only a few changes that you now 
want to reedit. If you choose REEDIT, go back to step b. 





— ENDSESSION (F4) — See explanation under step a. 
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The following paragraphs describe the procedure for manually executing the parameter 


SPERRY UNIVAC OS/3 10-38 
SYSTEM INSTALLATION 


PROCEED (XMIT) — This option lets you either proceed to the next 
paragraph you indicated in step 10. Or, it automatically takes you back 
into the SYSGEN dialog if you made radical changes to your old audit file. 
lf you did not make radical changes, it lets you terminate this auditing 
session when you have no other paragraphs to change. When you've 
made all your changes and, if necessary, gone through the SYSGEN 
dialog, you receive a message that your dialog session terminated 
normally. At this point, the dialog then automatically exeuctes the 
parameter processor or terminates. Which action takes place depends on 
the response that your new audit file contains for the dialog question DO 
YOU WANT TO EXECUTE THE PARAMETER PROCESSOR’. If it contains 
‘“‘yves’’, go back to the beginning of this section for automatic execution of 
the parameter processor. If it contains ‘’no’’, go to 10.7.2.3.2 for manual 
execution of the parameter processor. 


Manual Execution of the Parameter Processor 


processor. You must process your SYSGEN parameter sets in this way if your sets are 
in any of the following forms: 


™ 8 §=©as parameters prepared using the general editor; 


= as source modules saved from a previous dialog session; 


™ as source modules created interactively and saved from a previous release; or 


™ as parameters, saved from a previous dialog session, and corrected by the general 


editor. 


To manually execute the parameter processor, proceed as follows: 


1. At your workstation in system mode, key in: 


RVASGSPARAM, , S=source-module ' rf 


where: 


S 


Pe Na AA 
pga aia ee 


Se ee 


fi tol | bal 





Identifies the name of the source module where you stored your 
parameter sets. 


Identifies the name of the file that contains that source module. 


identifies the volume serial number of the volume that contains that file. 
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NOTES: 


@ ‘If you do not supply a value for the S parameter, the parameter processor asks 
whether you want to run interactively through the SYSGEN dialog. Respond Y 
for yes if you have not prepared SYSGEN parameters. If you respond N for no, 
the parameter processor will request the name of the source module where 
you stored your parameter sets. 


gw ‘If you don't specify a volume serial number, the default is your SYSRES 
volume. 


The parameter processor then processes and verifies your SYSGEN parameter sets. 
It provides a complete listing of all your parameter values, defaults, errors in your 
sets, and the execution sequence of the job control streams that you must execute. 
lf the processor finds no errors in your sets, carefully check the SGSPARAM listing 
to be sure that all its default substitutions are correct for your situation and the 
type of system you are generating. Then, proceed to the procedure for running the 
SYSGEN job control streams presented in 10.7.2.4. If the processor finds errors in 
your sets, it will also display a message on your screen informing you of the 
number of errors in your sets. 


2. If the parameter processor finds errors in your sets, correct or change your 
parameter sets using the parameter processor output listing as a guide to the 
errors. Use the general editor according to the instructions in the general editor 
user guide/programmer reference, UP-8828 (current version) to correct your 
parameters. When using the editor, specify the source module name that contains 
your parameter sets and the name of the file containing this source module. 


When you correct all errors in your parameter sets, rerun the parameter processor 
starting at step 1 of this procedure. 


10.7.2.4. Step 4 — Running the Prefiled SYSGEN Job Streams 


You actually accomplish system generation by running the SYSGEN job control streams 
that the parameter processor lists collectively in its output listing and that the dialog 
processor lists individually on the workstation screen. The parameter processor selects 
these job streams based on your phase and parameter specifications. Run the SYSGEN 
job streams, at your workstation in system mode, one at a time in the order in which 
they appear on the workstation screen and in the parameter processor output list. You 
must wait until each job is completed before executing the next job in its sequence. 
This manual gives the names and functions of each prefiled SYSGEN job stream that 
can appear in the output listing and on the screen in 1.3.1. 


NOTE: 


Do not rerun SGSPARAM until all the jobs listed in the parameter processor output 
listing have been run; otherwise, the variables generated by the first execution of 
SG$PARAM will be lost and you will be able to run only the jobs listed for the current 
(second) execution of SGSPARAM. 
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The following SYSGEN procedures are identical in both batch and interactive systems. 
To perform these procedures, refer to the indicated procedure descriptions in 10.7.1. 


= Creating a new SYSRES volume (10.7.1.5) 

= Generating a supervisor without creating a new SYSRES (10.7.1.6) 
m= Emulator generation (10.7.1.7) 

m= ICAM generation (10.7.1.8) 

m= NTR generation (10.7.1.9) 


a ANSI'74 COBOL processing option value generation (10.7.1.10) 


10.8. POST-SYSGEN PROCEDURES 


After you complete your SYSGEN operation, we recommend that you perform the 
following post-SYSGEN procedures (10.8.1 through 10.8.8). 


10.8.1. Updating the System Definition File 


If your system contains workstations, you must update the system definition file 
(SYSSDF) each time you generate a new or updated OS/3 release or each time you 
install a system maintenance package (SMP). This update is necessary because, even 
though these processes add the microcode for those workstations to the system 
microcode file (SYSMIC), they don't automatically place the names of that microcode in 
SY$SDF. Therefore, the microcode names in $Y$SDF don’t match the actual microcode 
in SY$MIC. 


However, for your system to operate correctly, the microcode names in $Y$SDF must 
match the names of the actual microcode in $Y$MIC. Whenever they don't match, you 
must update $Y$SDF to reflect the names of the actual microcode that your system 
contains. 


The system release document (SRD) that accompanies an OS/3 release informs you if 
the release changes the microcode in $Y$MIC; the SMP document that accompanies an 
SMP gives this information concerning SMPs. 


To update $Y$SDF, Sperry Univac supplies the system definition utility (GSDU). The SDU 
provides three functions that let you: 


= Add a new device to $Y$SDF 
m Delete an existing device from $Y$SDF 


= Update information for an existing device in $Y$SDF 
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The SDU also has a print/display capability that lets you print the contents of $Y$SDF 
on your system printer or display its contents on your system console. By checking the 
contents of SYSSDF both before and after you perform one of the update functions, 
you can be sure that the SDU properly updated $Y$SDF. 


We also provide a facility to display the contents of $Y$MIC at your system console. 
SY$SMIC contains the information that SDU requests from you concerning the microcode 
In your system. 


The actual updating of SY$SDF is made up of several steps which are shown in the 
overview in Figure 10—1. The first step you must perform is to display the contents of 
SYSMIC to review the microcode applicable to your system. This review provides you 
with information that the SDU specifically requests as input when updating $Y$SDF. 


Next, you must review the contents of $Y$SDF and compare it to the contents of 
SYSMIC to determine which entries in $Y$SDF you must update (add, delete, or 
modify). After determining what to update, select the appropriate SDU update procedure 
and proceed to update the contents of $Y$SDF. When completed, review the contents 
of SYSSDF to confirm that the file was updated correctly. Once you have made certain 
that the microcode names in $Y$SDF now match the actual microcode in $Y$MIC, you 
can terminate the SDU. 


UPDATING $Y$SDF 
DISPLAY CONTENTS 
OF $Y$MIC 
INITIATE 
Se ee oe ee SDU 
DISPLAY /PRINT CONTENTS 

OF $Y$SSDF 
DETERMINING 
WHAT REQUIRES 


UPDATING COMPARE $Y$MIC WITH 
$YSSDF TO DETERMINE 
UPDATE REQUIREMENTS 


SELECT UPDATE 
OPERATION TO BE 
PERFORMED 











DELETE DEVICE UPDATE INFORMATION 
FROM 
$Y$SDF $YS$SDF 


ADD DEVICE 


$YSSDF 


DISPLAY /PRINT 
CONTENTS OF $YS$SDF 
TO CONFIRM UPDATE 


TERMINATE 
SDU 


Figure 10-1. Updating of $Y$SDF 
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The procedures for updating $Y$SDF are presented in the following order: 


le 


4, 


Determining What to Update by Reviewing the Contents of $YSMIC and $YS$SDF 


2. Adding a Device to $Y$SDF 

3. Deleting a Device from $Y$SDF 
Updating Existing Device Information in $Y$SDF 

5. Confirming that $Y$SDF is Updated Correctly 

NOTES: 

1. With the exception of the messages included here, the system messages manual, 
UP-8076 (current version) describes all messages concerning this procedure in the 
section on unprefixed messages. 

2. To perform this procedure, we assume that your system is operating under the 


control of either the starter supervisor or one that you've generated yourself. 


10.8.1.1. Determining What to Update by Reviewing Contents of 


A: 


Z. 


$YSMIC and $Y$SDF 

At your console/workstation in console mode, key in: 

FSTAT ,SY$MIC,RES 
Then press XMIT. The contents of $Y$MIC is displayed at your system console. 
Record the following information: 

— microcode device 

— microcode type | 

— microcode name 


The SDU will request this information from you later. 





UP-8074 Rev. 11 SPERRY UNIVAC 0S/3 


10-43 
SYSTEM INSTALLATION 


Update B 





& 3. Key in SDU, then press XMIT. The operation request screen is displayed at the 
J console/workstation: 










SYSTEM DEFINITION UTILITY DIALOGUE 
ENTER THE OPERATION TO BE PERFORMED 


1. ADD A DEVICE TO $SYSSDF FILE 

2. DELETE A DEVICE FROM SYSSDF FILE 

5. UPDATE DEVICE INFORMATION IN $YSSDF FILE 
4 

5 














- PRINT/DISPLAY ENTRY(S) IN SYSSDF FILE 
- TERMINATE SDU. 


SDU Operation Request Screen 


4. Key in 4, then press XMIT. The _ print/display screen is displayed at the 
console/workstation: 


ENTER OPERATION TO BE PERFORMED 
1. DISPLAY ALL ENTRIES 

2. DISPLAY BY DEVICE 

3. PRINT ALL ENTRIES 

4. TERMINATE PRINT/DISPLAY 
















SDU Print/Display Screen 


This print/display screen offers you several choices for checking the contents of 
SY$SDF for comparison to $Y$MIC: 


a. DISPLAY ALL ENTRIES 


Displays the entire contents of $Y$SDF on the console/workstation screen in 
the following format: 


DVC ADDR TYPE MICROCODE NAME SERIAL NUMBER 
HHHH AAAA AAAAAAAA AAAAAAAA 


FCO NUMBER 
XXXXX - XXXX 


@ Note: H-hexdigit, A-alphanumeric, X-decimal 


The information is displayed in 10-line increments. 
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b. DISPLAY BY DEVICE 


Displays all entries in $Y$SDF for a particular device address. The format is 
the same as shown for choice 1. 


c. PRINT ALL ENTRIES 


Prints the entire contents of $Y$SDF on the system printer. The format is the 
same as shown for choice 1. 


5. Key in 1, then press XMIT if you want to display the entire contents of SY$SDF on 
your console/workstation screen. Otherwise, proceed to next step. Because the 
SDU displays the contents of $Y$SDF in 10 line increments, you must key in Y and 
press XMIT each time the following message appears to view the next 10 lines of 
information: 


DO YOU WISH TO CONT (Y,N) 


To discontinue the display and return to the print/display screen, key in N and 
press XMIT. 


6. Key in 2, then press XMIT if you want to display all entries in SY$SDF for a 
particular device address. Otherwise, proceed to next step. When the following 
message appears: 


ENTER ‘IMPL’ OR DVC ADDRESS HHH TO BE DISPLAYED 
Key in either IMPL or the address of the device you want displayed. 
If no entries exist for the device specified, SDU displays the message: 
NO ENTRIES FOUND FOR THIS DEVICE 
When the display is completed, press XMIT to return to the print/display screen. 

7. Key in 3, then press XMIT if you want to print the entire contents of $Y$SDF. 
Otherwise, proceed to next step. When printing is complete, press XMIT to return 
to the print/display screen. 

8. Compare the contents of $Y$SDF (obtained in step 5, 6, or 7) with the contents of 
$Y$MIC (obtained in step 2). From this comparison, determine which entries must 
be updated in $Y$SDF. 
lf no update is necessary, terminate SDU as follows: Press XMIT. When the 
print/display request screen is displayed, key in 4 and press XMIT. When the 


Operation request screen is displayed, key in 5 and press XMIT. If $Y$SDF requires 
updating, proceed to next step. 


9. Key in 4, then press XMIT. The print/display screen terminates, and the operation 
request screen is redisplayed. 
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¢ 10. Determine from the options listed in the operation request screen, which function 
you want to perform. 


— If you want to add a device to $Y$SDF, proceed to 10.8.1.2 
— If you want to delete a device from $Y$SDF, proceed to 10.8.1.3, or 


— If you want to update existing device information in $Y$SDF, proceed to 
10.8.1.4. 


10.8.1.2. Adding a Device to $Y$SDF 


Do not perform the following procedure unless you have completed steps 1 through 9 
of 10.8.1.1 or are continuing from one of the other $Y$SDF update procedures. 


1. Key in 1 on the SDU operation request screen, then press XMIT. SDU displays the 
message: 


N=NUMERIC X=ALPHANUMERIC H=HEXADECIMAL 
ENTER ‘IMPL’ OR DVC ADDRESS HHH TO BE ADDED 


2. Key in ‘IMPL’ or the address of the device you are adding, then press XMIT. SDU 
then displays one of the following messages, depending on whether you entered 
& ‘MPL’ or a device address: 
If you entered ‘IMPL’, SDU displays this message: 
ENTER ‘CPU’, ‘DBUS’, ‘IOMP’, or ‘CACH' 


Respond to this message by entering the type of IMPL you are adding and proceed 
with step 3. 


lf you entered an address, SDU displays this message: 
ENTER THE DEVICE TYPE NNNN OR ‘WSC’ 


Respond to this message by entering the four-character device type you are adding 
or ‘WSC’ for workstation controller and proceed with step 3. 


NOTE: 


If you keyed in the address for a device not configured in your system, SDU 
displays the message: 


DEVICE NOT CONFIGURED, DO YOU WISH TO CONTINUE (Y,N) 


If you keyed in the address for a device that is configured but is nonloadable, SDU 
& diplays the message: 


DEVICE NOT LOADABLE, DO YOU WISH TO CONTINUE (Y,N) 





UP-8074 Rev. 11 SPERRY UNIVAC OS/3 10—46 


SYSTEM INSTALLATION Update B 


To continue the procedure in either case, key in Y, then press XMIT. If you don't 
want to continue the dialog, key in N then press XMIT. The operation request 
screen will be redisplayed. 


Press the XMIT key. The SDU displays the message: 
ENTER MICROCODE NAME XXXXXXNN OR ‘NONE’ 


Key in the 1-8 character name for the microcode you are adding, or NONE, then 
press XMIT. SDU displays the message: 


ENTER SERIAL NUMBER XXXXXXXX OR ‘NONE’ 


Key in the serial number of the specified device or NONE, then press XMIT. SDU 
displays the message: 


ENTER FCO NUMBER NNNN-NN OR ‘NONE’ 


Key in the FCO number for the specified device or NONE, then press XMIT. SDU 
redisplays the operation request screen. 


lf you want to add another device to $Y$SDF, repeat steps 1-7 of this procedure. 


If you want to perform one of the other SDU update functions listed on the 
operations request screen, refer to the appropriate procedure: 


— To delete a device, see 10.8.1.3. 
— To update existing device information, see 10.8.1.4. 


— To confirm your $Y$SDF update, see 10.8.1.5. 


10.8.1.3. Deleting a Device from $Y$SDF 


Do not perform this procedure unless you have completed steps 1 through 9 of 
10.8.1.1 or are continuing from one of the other $Y$SDF update procedures. 


1. 


2. 


Key in 2 on the SDU operation request screen, then press XMIT. SDU displays the 
message: 


~N=NUMERIC X=ALPHANUMERIC H=HEXADECIMAL 
ENTER ‘IMPL’ or DVC ADDRESS HHH TO BE ADDED 


Key in ‘IMPL’ or the address of the device you are deleting, then press XMIT. SDU 
then displays one of the following messages, depending on whether you entered 
‘IMPL’ or a device address. 


If you entered ‘IMPL’, SDU displays this message: 


ENTER ‘CPU’, ‘DBUS’, ‘IOMP’, or ‘CACH’ 
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Respond to this message by entering the type of IMPL you are deleting and 
proceed with step 3. 





If you entered an address, SDU displays this message: 
ENTER THE DEVICE TYPE NNNN OR ‘WSC’ 


Respond to this message by entering the four-character device type you are 
deleting or ‘WSC’ for workstation controller and proceed with step 3. 


3. Press the XMIT key. SDU redisplays the operation request screen. 


4. If you want to delete another device from $Y$SDF, repeat steps 1 through 3 of 
this procedure. 


5. If you want perform one of the other SDU update functions listed on the operation 
request screen, refer to the appropriate procedure: 


— To add a device, see 10.8.1.2. 
— To update existing device information, see 10.8.1.4. 


— To confirm your $Y$SDF update, see 10.8.1.5. 


10.8.1.4. Updating Existing Device Information in $Y$SDF 


Do not perform this procedure unless you have completed steps 1 through 9 of 
10.8.1.1 or are continuing from one of the other $Y$SDF update procedures. 


1. Key in 3 on the SDU operation request screen, then press XMIT. SDU displays the << 
message: 


N=NUMERIC X=ALPHANUMERIC H=HEXADECIMAL <= 
ENTER ‘IMPL’ OR DVC ADDRESS HHH TO BE ADDED 


2. Key in IMPL or the device address of the device you are updating, then press y 
XMIT. SDU then displays one of the following messages, depending on whether 
you entered ‘IMPL’ or a device address. 
If you entered ‘IMPL’, SDU displays this message: 
ENTER ‘CPU’, ‘DBUS’, ‘IOMP’, or ‘CACH’ 


Respond to this message by entering the type of IMPL you are updating and 
proceed with step 3. 


@ lf you entered an address, SDU displays this message: 


ENTER THE DEVICE TYPE NNNN OR ‘WSC’ 
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Respond to this message by entering the four-character device type you are 
updating or ‘WSC’ for workstation controller an proceed with step 3. 


3. Press the XMIT key. SDU displays the message: 
ENTER MICROCODE ID XXXXXXNN OR ‘CLEAR’ (DEFAULT NO CHANGE) 


4. Key in the new microcode name if you want to change the name of a microcode 
entry in $Y$SDF or CLEAR if you want to delete the microcode name for a device 
that is no longer loadable or configured; then press XMIT. If microcode is to remain 
unchanged, simply press XMIT. SDU displays the message: 


ENTER SERIAL NUMBER XXXXXXXX OR ‘CLEAR’ (DEFAULT NO CHANGE) 


NOTE: 


You cannot use ‘CLEAR’ to delete the microcode name for a loadable, configured 
device. If you try to do so, SDU displays the message: 


CANNOT CLEAR MICROCODE NAME, ENTER NEW NAME OR NULL STRING IF 
NO CHANGE 


To continue the procedure, either enter a new microcode name and press XMIT, or 
simply press XMIT if the name is to remain unchanged. 


5. Key in a new Serial number of ‘CLEAR’ if you want to delete an old number, then 
press XMIT. If the serial number is to remain unchanged, simply press XMIT. SDU 
displays the message: 


ENTER FCO NUMBER NNNN-NN OR ‘CLEAR’ (DEFAULT NO CHANGE) 
6. Key in the new FCO number or ‘CLEAR’ if you want to delete an old number; then 
press XMIT. If the FCO number is to remain unchanged, simply press XMIT. SDU 


redisplays the operation request screen. 


7. ‘tf you want to change information for another device, repeat the steps of this 
procedure. 


8. If you want perform one of the other SDU update functions listed on the operation 
request screen, refer to the appropriate procedure: 


— To add a device, see 10.8.1.2 
— To delete a device, see 10.8.1.3 


— To confirm your $Y$SDF update, see 10.8.1.5. 
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10.8.1.5. Confirming Your $Y$SDF Update 


This procedure is performed after you have completed S$Y$SDF updating procedures, 
provided in 10.8.1.2, 10.8.1.3, or 10.8.1.4. 


1. Key in 4 on the SDU operation request screen, then press XMIT. SDU displays the 
print/display screen. 


2. Key in 1 or 3 on the print/display screen, then press XMIT. SDU displays or prints 
(based on your entry) the entire contents of $Y$SDF. 


3. Check current entries in $Y$SDF to make certain that SDU performed your update 
properly. 


4. Press XMIT to redisplay the print/display screen. 
5. Key in 4, then press XMIT. SDU displays the operation request screen. 


6. If SYSSDF is not properly updated, repeat the appropriate update procedure 
provided in the paragraphs that follow: 


See 10.8.1.2 to add a device 
See 10.8.1.3 to delete a device 
See 10.8.1.4 to update existing device information. 


7. If $YSSDF is properly udpated, key in 5 then press XMIT. SDU terminates. 


10.8.2. Copying and Restoring $Y$SDF 

If you are an existing Series 90 user and are installing a new release, you can make a 
copy of your old $Y$SDF file and later restore it to your new SYSRES with the 
jobstreaam SDFSAVE. This jobstream lets you copy $Y$SDF from your old SYSRES to 
any of the following types of media: 

1. Single-sided single-density diskette 

2. Tape 


3. Another disk volume (other than your SYSRES) 
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If you use diskette or tape, SDFSAVE preps the media and allocates a file to contain the 
copied version of $Y$SDF. If you use another disk volume, you must prep this volume 
and allocate a file for $Y$SDF yourself. 


After you install your new release, you can run SDFSAVE again to restore $Y$SDF from 
the diskette, tape, or disk media to your SYSRES volume. Thus, you do not have to 
completely recreate $Y$SDF each time you install a new release. 


To run SDFSAVE, mount the media you are copying to or restoring from and enter the 
following command at your system console: 


RV SDFSAVE 


Here are the messages that appear on the console screen along with the responses you 
must enter when running SDFSAVE: 


ENTER THE APPROPRIATE FUNCTION’ (DUMP OR RESTORE) 


Enter DUMP if you want to make a copy of $Y$SDF or RESTORE if you want to restore 
SY$SDF to your SYSRES. 


THEN ENTER THE DEVICE TYPE. (DISK, DISKETTE, or TAPE) 
Enter the type of media you are copying to or restoring from. 
THEN ENTER THE VOLUME NAME FOR THE GIVEN DEVICE TYPE 
Enter the volume serial number of the media you are copying to or restoring from. 


WHEN DUMPING TO TAPE OR DISKETTE THE VOLUME NAME WILL BE USED FOR 
THE PREP 


This is the last message displayed. You respond to it be pressing XMIT and SDFSAVE 
then performs the copy or restore function you specified. 


10.8.3. Modifying the OS/3REL Volume Library Files 


If you are using the OS/3REL volume as your permanent SYSRES, you may have to 
perform the following two additional procedures to modify the contents of your library 
files. When you create a new SYSRES, you make these modifications during the 
RESGEN phase of SYSGEN. 


10.8.3.1. Configuring the 2K Version of COS Code 


To use the IMS, FORTRAN IV, extended COBOL, or COBL74 processors, you must 
replace the 1K version of the control storage (COS) code in the COS load area on the 
OS/3REL with the 2K version. The procedure for configuring the 2K version of COS 
code is outlined in the system service programs user guide, UP-8062 (current version). 
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10.8.3.2. Deleting SYSGEN Files from the Release Volume 


If you are using the OS/REL volume as your permanent SYSRES, you can scratch the 
SYSGEN files from the release volume by keying in the following system command: 


RVASGSSCR 


NOTE: 


lf you run this job stream, it is the last post-SYSGEN operation performed on the 
OS/3REL library files. 7 


10.8.4. Changing the System Bulletin 


The system bulletin is displayed whenever a user logs on to a workstation, or a terminal 
being used as a workstation. The system bulletin can be used to inform workstation 
users of system information, such as hours of system operation. 


Initially, the system bulletin displayed is the default bulletin. This bulletin, which 
describes how to enter commands, is provided with the OS/3 interactive software you 
receive from Sperry Univac. It is as follows: 










TODAYS BULLETIN IS: 
-- TO TYPE IN COMMANDS, DEPRESS ‘FUNCTION' AND -- 
-- 'SYSTEM MODE' KEYS SIMULTANEOUSLY, THEN TYPE -- 
-- THE COMMAND AND DEPRESS TRANSMIT. -= 


-~- ON UNISCOPES DEPRESS 'MESSAGE WAITING! KEY. -- 


If you want to use the system bulletin to display other messages, you must change it, 
overwriting the present bulletin. 





The system bulletin resides in a module named BULLETIN, in the $Y$SRC file, on the 
SYSRES volume. To change the bulletin, you must overwrite the contents of BULLETIN: 
there can be only one bulletin at a time in the $Y$SRC file. 


You can change the bulletin in two ways. The first is to use the general editor to 


change the bulletin interactively. The second is to use the librarian in a batch 
environment. 
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@ General Editor 


The following is an example of how to change the bulletin using the general editor: 


LOGON PAULM 
EDT 


0900 @DELETE 1 4 

0000 SYSTEM AVAILABLE FROM 0960 TO 199@ TODAY 
- 9000 @WRITE MODULE=BULLETIN, FILENAME=$YS$SRC 
2.0000 aHALT 

LOGOFF 


1.9000 @READ MODULE=BULLETIN, FILENAME=$Y$SRC 

>. 9000 @PRINT 1 4 

1.0000 -- TO TYPE IN COMMANDS, DEPRESS ‘FUNCTION! AND -- 
2.9000 -- 'SYSTEM MODE' KEYS SIMULTANEOUSLY, THEN TYPE -- 
5.9000 ~- THE COMMAND AND DEPRESS TRANSMIT. 

4.9000 -- ON UNISCOPES DEPRESS ‘MESSAGE WAITING! KEY. -- 
> 

1 

2 


m §=Librarian Change 
The following is an example of how to change the bulletin using the librarian: 


// JOB BULLADD 
// DVC 20 // LFD PRNTR 
// EXEC LIBS 
/$ 
FIL D1=S$YSSRC 
ELE.D D1,S,BULLETIN 
SYSTEM AVAILABLE FROM 0960 TO 1900 TODAY 
EOD 
/* 
/8 
// FIN 


NOTE: 


In the ELE statement, the D option causes the contents of the module (the bulletin text) 
to be printed. | 


When creating new text for the system bulletin, you must follow these rules: 


Do not write more than 60 characters in each line of the bulletin. 


Do not create a bulletin more than 20 lines long. 


— Do not use the dollar sign ($) as the first character of a line. 


Be sure that all of the characters in the bulletin text are printable characters. 


If you want to save the default bulletin for future use, use the COPY command to copy 
it into another module in $Y$SRC. When you want to re-use the default bulletin, simply 
copy it back into the BULLETIN module. 
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10.8.5. Verifying System Installation 


After you create your tailored SYSRES, we recommend that you verify successful 
installation of your version of OS/3. To do so, use the procedures outlined in the 
installation verification procedures user guide/programmer reference, UP-8820 (current 
version). If you created your SYSRES using the RESGEN phase, you must have specified 
IVP in the RESGEN INCLUDE/DELETE parameter to run the IVPs. 


10.8.6. Making a Backup Copy of Your SYSRES 


After you completely tailor your SYSRES and verify system installation, we recommend 
that you make a backup copy of your SYSRES by using the SETREL/COPYREL or DCOP 
procedures outlined in 10.4. SETREL/COPYREL allows you to copy your release volume 
to any type of disk but requires more time to execute; DCOP requires less execution 
time, but allows you to copy your release volume only to the same disk type. 


10.8.7. Special Considerations for FORTRAN Installations 


The OS/3 release volume (OS/3REL) contains two sets of FORTRAN compiler macros in 
the system macro library (SYS$MAC). It also contains two sets of FORTRAN compiler 
object modules in the system object code library (SYSOB4). 


One set, called MIX, supports both CDI and DTF data management facilities. The other 
set, called DTF, supports only the DTF data management facility. As delivered, the 
OS/3REL favors the DTF-only data management by default because the DIF set comes 
first on the volume. 


The following special considerations and procedures may apply to your FORTRAN 
installation, depending on the type of data management you configured your supervisor 
to support. 


lf you use the OS/3REL volume as your SYSRES and you configured your supervisor to 
use CDI data management support (In other words, you_ specified either 
DMGTMODE=CDI or DMGTMODE=MIXED during SUPGEN), you must reverse the order 
of the FORTRAN modules in $Y$MAC and $Y$OBJ before you assemble a unit 
definition or link a FORTRAN IV object program. Until you switch the order of the 
modules, you will encounter errors when using the FORTRAN IV compiler run-time 
modules in a CDI environment. 


To reverse the order of the FORTRAN modules to favor a CDI environment, on the 
prefiled job stream, MIXFOR4, by keying in: 


RVAMIXFOR4 


lf you later want to switch back to the original DTF-only support, run the prefiled job 
stream, DTFFOR4, by keying in: 


RVADTFFOR4 
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Further, if you are using both CDI and DTF data management facilities 
(DMGTMODE=MIXED during SUPGEN), and you intend to use both FORTRAN 
compilers, you must copy the DTF procs to an alternate library before you can use the 
basic FORTRAN compiler. Then, whenever you assemble the unit definition for a basic 
FORTRAN program, you must supply the assembler with the name of the alternate 
library that contains the DTF procs. To do this, use the LIN parameter on the // 
PARAM statement during the assembly operation. 


To copy the DTF procs to an alternate library, you must use the system librarian, LIBS, 
which we describe in the system service programs user guide/programmer reference, 
UP-8062 (current version). 


A sample job control stream to copy the DTF procs to an alternate library follows. Note 
that we deliver the DTF procs under the group name 9$FORPDT. 


// JOB FORTALT 

// DVC 20 // LFD PRNTR 

// OVC RES 

// EXT ST,C,,CYL,1 

// LBL ALTER1 

// LFD alternate Library name 

// EXEC LIBS 
FIL DO=SYSMAC, Di=alternate library name 
COP.CG DO,,9$FORPDT,D1 

/* 

/& 

// FIN 


In this control stream example, we are copying the DTF procs, those under the group 
name, OYSFORPDT, to an alternate library on the OS/3REL volume (which is also the 
SYSRES volume). 


lf you build your SYSRES on a disk other than the OS/3REL volume and you configured 
your supervisors to use both CDI and DTF data management facilities 
(DMGTMODE=MIXED during SUPGEN), then the SYSGEN job control streams reverse 
the order of the FORTRAN compiler modules on your SYSRES to favor CDI support. 
However, you must still copy the DTF procs to an alternate library as previously 
described, if you intend to use the basic FORTRAN compiler. 


Remember that you cannot use the basic FORTRAN compiler if you configured your 
supervisor to use CDI-only data management (DMGTMODE=CDI during SUPGEN). 
10.8.8. Updating the ICAM Symbiont Table 

lf you generate an ICAM element and later copy this element to another disk device, 


you must update the ICAM symbiont table after you perform the copy. To update the 
symbiont table, we provide the SGTRAN job control stream. 
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The job control listing that was generated when you first ran SGSCOMMK to create the 
ICAM element contains the input parameter values from the original SGTRAN run. You 


must use these values whenever you run SGTRAN to update the symbiont table. The ~ 


following job control stream is a sample execution of SGTRAN: 


1. // JOB SGTRAN 
2. // OVC 20 // LFD PRNTR 
3. // DVC 51 // VOL SYSRES // LBL $Y$LOD // LFD SYSLOD 
4. // DVC 51 // VOL SYSRES // LBL $Y$TRAN // LFD IN1 
5. // DVC 51 // VOL SYSRES // LBL $Y$TRANA // LFD OUT 
6. // OPTION JOBDUMP 
7. // EXEC SGTRAN,SYSLOD 
8. // PARAM M9,04,02,00,1 
9. /& 
10. // FIN 

NOTE: 


Line 8 contains the input positional parameter values from the original SGTRAN run. 
These values specify the following: 


M9 2-alphanumeric-character message control program (MCP) 
04 2-digit decimal number of task control blocks (TCBs) assigned. 


O2 2-digit decimal number of open file DTFs which are associated with 
DISCFILE/JRNFILE macros 


OO 2-digit decimal number of physical unit blocks (PUBs).One PUB is required for 
each local workstation specified. If the ICAM element contains remote batch 
processing (RBP), this number must be equal to or greater than 17. 


1 Single-digit internal symbol dictionary generation. Set to O for TRANSIENT TCls 
and to 7 for all others. 
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11. System Maintenance 


11.1. WHAT ARE SYSTEM MAINTENANCE PACKAGES? 


System maintenance packages (SMPs) contain system maintenance changes (SMCs) that 
you install in your SYSRES volume to support your OS/3 software’s operation and 
effectiveness. We deliver SMPs to all Series 90 customers at regular intervals, usually 
every two to three months, on tape or disk. We recommend that you order SMPs on 
tape unless your system does not support this media. lf you order the SMP on disk, 
you must send a copy of your SYSRES to Sperry Univac so we can copy all the SMP 
software to this volume and then return it to you. Regardless of the media you order, 
the SMP is accompanied by an SMP document that you must read before installing the 
SMP. 


The SMP document gives information about the specific SMP you are installing, the 
amount of time required to install the SMP, and the processing options you should 
specify during installation. Although the options you select may vary with each SMP, we 
recommend that you follow these general guidelines whenever you install an SMP: 


= Install all SMPs as soon as possible upon delivery. 


= Install SMPs in the order that we deliver them. For example, SMP 8A must be 
installed in your system before you can install SMP 8B, SMP 8C, etc. The SMP 
installation program will terminate in error and therefore will not install an SMP if 
your system does not contain the previous SMPs. 


= Do not install SMPs while running other jobs because SMPs affect your operating 
system and unpredictable results could occur. 


m= Before you execute the SMP program, be sure you have a current and complete 
copy of your SYSRES volume. To do so, see 10.4. 


= You may install SMPs and SMCs only to the OS/3REL volume with all the system 
files on it. If your OS/3REL is not your SYSRES volume, you must install the SMP> 
on the OS/3REL. Then, after the SMP procedure terminates, you must regenerate 
your system and include a RESGEN section to place the SYSGEN output on your 
SYSRES. Last, you must copy any of your own files and modules (that you keep on 
SYSRES) from your backup SYSRES to your new SYSRES. 
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To copy your files onto your new SYSRES, use the COP statement of the system 
librarian, LIBS. To copy your modules back into your system files on your new 
SYSRES, use the ADD statement of the librarian. The system service programs 
user guide, UP-8062 (current version), describes use of the librarian and its 
statements in full detail. 


To make system maintenance as easy as possible, we provide two _ installation 
programs. One program installs an SMP and the other installs individual SMCs that you 
require, but have not yet received as part of an SMP. These programs are very similar, 
and you can run them either from the system console or from a workstation. Each 
offers additional processing options that let you regenerate supervisors or ICAM 
symbionts or realign the system files SY$LOD and $Y$JCS if any of these are affected 
during SMP or SMC installation. 


In addition, you can direct each program to keep a copy of the affected modules in your 
SYSRES files as they are, before you install am SMP or SMC. These copies are saved in 
areas called back-out files on your SYSRES volume. We recommend that you specify 
this option as a precautionary measure in case an SMP or SMC produces adverse 
effects on your system and you must back it out under the direction of a Sperry Univac 
representative. By keeping the back—out copy, you can restore your system to the way 
it was before you installed the SMP or SMC. 


For now, we'll give you an overview of the SMP and SMC installation programs and the 
options you can choose when you run them. We'll discuss the SMP program in more 
detail, but remember that you can also perform the same operations by running the 
SMC program. We'll also tell you about the additional options you can specify when 
you run the SMC program. Later in this section, we'll explain the procedures for running 
each program. 


11.2. THE SMP INSTALLATION PROGRAM 


As mentioned earlier, you can install SMPs either from a workstation or from the 
system console. Since you can perform all the installation tasks from either of these 
devices, choose whichever device you prefer. However, we recommend that you use a 
workstation since the SMP program provides help screens only to the workstation user. 
Of course, if your system does not have workstations, you must use the system 
console. 


To install an SMP, enter the following command at the system console or at any 
workstation. 


RV od 
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This command calls the SMP installation program and has one optional parameter 





which lets you specify whether or not you want to use the back-out feature. If you use 
this feature, the following guidelines apply: 


= The use of the back—out feature increases the time required to install an SMP and 
requires additional disk space on your SYSRES to hold the saved modules. 
Therefore, the back—out parameter default is N (for no) and you must specify B=Y 
(for yes) to use the back—out feature during SMP installation. 


= The SMP program creates the following files on your SYSRES volume. If you use 
the back—out feature, these files must be kept consistent with each other and you 
must not delete or change the contents of any of these files: 


SMCFILE A SAT library containing all SMCs that are part of an SMP. 


$Y$SMCLOG A MIRAM file containing information relating to all the SMCs 
applied to the system. 


sites to Files used by the SMC/SMP programs as back—out files if 
SMCBTRAN that option is specified. 
M$ files Files that contain modules required by SMCs during SMP or 


SMC installation. 


m= To regain space on your SYSRES, you can create backup copies of these files on 
another disk, on tape, or on diskette, and then erase the files from your SYSRES 
(except for $Y$SMCLOG, which is a system file and therefore cannot be erased). 
Remember that, if you want to preserve back-out capability, you must restore these 
files to your SYSRES before running the SMP or SMC installation program again. 


= The first time you run the SMP program to install a new SMP, the SMCFILE, 
S$Y$SMCLOG, SMCBSAT, SMCBMIR, and SMCBTRAN are initialized and all existing 
M$ files are deleted. Therefore, SMCs that have already been installed may no 
longer be backed out. On each subsequent SMP run, all SMP-related files are 
reinitialized; all M$ files are deleted unless you specify the back-out feature (B= Y) 
when you enter the SMP run command. 


As each SMC in an SMP is applied, the modules changed by the SMC are stored in 
the appropriate back—out files and the entry in $Y$SMCLOG is marked BACKED 
UP. Each module is stored in the back—out file only once. Thus, each module in the 
back—out file is stored as it was prior to the application of any of the SMCs in the 
SMIP. 


When either the SMP or SMC program is run to back—out an SMC, any other SMCs 
which affect the same modules are reapplied during the run. 
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s If you apply additional SMCs after installing an SMP, the new SMCs are added to 
the SMCFILE that was created by the original SMP run. Also, any additional 
modules affected by the new SMCs are added to the back—out files. The end result 
is the same as if the new SMCs had been included in the SMP. 


After you enter the SMP run command, press XMIT to display a list of options on the 
console or workstation screen. How these options appear depends on whether you're 
working at a workstation or a console. 


If you enter the command at a workstation, these options appear in menu format as 
shown in Figure 11-1: 


SMP APPLICATION SCREEN 1 - PROCESSING OPTIONS MENU 


Apply SMP in normal mode (accept all defaults). 
Change normal defaults. 

Copy files from input media to RES pack only. 
Perform supervisor regenerations. 

Perform ICAM regenerations. 

Perform system Library realignment. 

Erase ‘SMCFILE,’ all backup files, and M$ files. 
Help - obtain additional information. 

Terminate with current changes. 


1. 
rae 
a 
4 

5. 
6. 
. 
8. 
9. 


Enter Selection number _ ; Press TRANSMIT. 


Press FUNCTION-F2 to cancel job. 





Figure 11-1. SMP Processing Options Menu 


You simply choose the option you want to perform, enter its number after the prompt 
at the bottom of the screen, and press XMIT. If you do not understand one of the 
options offered, you can request help (option 8) and display a screen that provides 
additional information on that particular option. If you want to cancel the SMP job, press 
FUNCTION and the F2 key simultaneously. Depending on the option you select, the SMP 
program either begins processing immediately or, if it needs more information, displays 
additional screens for you to respond to and then begins processing. 


lf you run the SMP program from the system console, the options shown in Figure 
11-1 appear as a series of messages that are scrolled up from the bottom of the 
screen. The help option is not displayed, however, since help screens are not provided 
to the console user. This is the final message displayed on the console screen: 


mm # SMPQ19 ENTER MENU SELECTION NUMBER (DEF:1) OR C: CANCEL JOB 
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To perform one of the options, press the MSG WAIT key to position the cursor at the 
beginning of the next line, and key in the number of the option you want to perform. 
Then, press XMIT. The program either begins processing immediately, or displays 
additional messages for you to respond to, depending on which option you select. 
Notice also that you can cancel the SMP job by entering a C and pressing XMIT, or you 
can accept the default of option 1 and install the SMP in normal mode simply by 
pressing XMIT. 


Let's discuss the operations you can perform with the SMP program. To simplify our 
discussion, we'll divide these operations into three categories: 


1. Installing an SMP to your system (options 1 and 2) 

2. Performing additional system maintenance tasks (options 4, 5, and 6) 

3. Erasing files created by the SMP program after installing an SMP (option 7) 
NOTE: 


Option 3 is provided if you order the SMP on tape but do not have tape support. 
You can go to a site with tape support and use this option to copy the SMP files 
to your SYSRES volume without actually installing the SMP. Then, enter the 
following run command to install the SMP: 


RV SMP,,INPUT=(D,RES) 


11.2.1. Installing an SMP to Your System 


You can install an SMP to your system either with normal default processing choices 
that we supply (option 1) or with nondefault choices that you specify (option 2). If you 
select option 1 and apply the SMP in normal mode, the installation program performs 
the following functions as part of its standard operation: 


w # Installs all the applicable system maintenance changes (SMCs) in the SMP. 


m= Regenerates SYSMIX and the supervisor you loaded to install the SMP (if not 
SY$MIX) if the SMP affects them in such a way that they must be regenerated to 
operate properly. 


m™ §Regenerates the basic C1 ICAM symbiont if the SMP affects it in such a way that it 
must be regenerated to operate properly. 


@ Prints an audit report of the status of all the SMCs in the package. 


When you install an SMP in normal mode, the program begins execution immediately 
and does not display any additional screens or messages. Throughout the SMP 
execution, with the exception of a brief time when the SMP job terminates and then 
reexecutes itself, the SMP job occupies job slot 1. While there, it executes jobs that 
correspond to the specific SMC that it is applying. These jobs occupy job slot 2. After 
it installs all the SMCs in an SMP, the SMP program initiates any necessary 
regenerations or realignments. When it completes these functions, the SMP program 
executes SMCLIST and terminates. 
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SMCLIST then occupies job slot 1 and prints the contents of $Y$SMCLOG. When 
SMCLIST has successfully printed this list, it displays a message to inform you that it 
has terminated normally. The SMP installation is then complete. We recommend that 
you keep the SMCLIST printout with your other system records so that you have a 
record of all the SMCs installed in your system. If you should ever need to print that 
list, see the system service programs user guide, UP-8062 (current version), which 
gives the instructions for executing SMCLIST as a separate function from the SMP 
process. 


If you select option 2 and install an SMP without the normal defaults, the program 
executes just as it does in normal mode with the exception that supervisor and ICAM 
regenerations are not performed automatically. Before execution begins, three additional 
screens or messages are displayed that let you specify the additional processing options 
you want to perform. You can: 


@  # regenerate up to three supervisors; 
™ regenerate up to three ICAM symbionts; and 
= ~=realign the system files $Y$JCS and $Y$LOD. 


In most cases, the defaults provided by option 1 of the SMP program should meet your 
processing needs. However, if you have supervisors or ICAM networks that are affected 
by an SMP but are not regenerated by the standard program or if you want to realign 
$Y$JCS or $Y$LOD, you must select option 2 to install the SMP. Refer to the SMP 
document we provide with each SMP if you need help deciding which option you should 
choose. 


11.2.2. Performing Additional System Maintenance Tasks 


The three additional screens or messages that are displayed when you select option 2 
on the processing options menu and install an SMP without defaults can also be 
displayed individually by selecting options 4, 5, or 6, respectively. Option 4 lets you 
perform supervisor regeneration, option 5 specifies ICAM regeneration, and option 6 
specifies system file realignment. By selecting one or more of these options, you can 
perform additional regenerations or realignments after you install an SMP should the 
need arise. 


Regardless of whether you are performing these tasks during or after SMP installation, 
to regenerate supervisors or ICAM networks, the SMP program automatically uses the 
same parameter input that you specified when you originally generated your operating 
system. To do this, the parameter input must reside in the system source library 
(SYSSRC)) on the OS/3REL volume and must not contain any errors. If your parameters 
are in the form of keypunched cards, you can use the ELE statement of the system 
librarian, LIBS, to transfer the parameter input from cards to $Y$SRC on your OS/3REL 
volume. If you used the SYSGEN dialog to prepare your parameter sets, those sets 
already reside in $Y$SRC on your SYSRES volume under the source module name you 
specified at the end of the dialog. However, if your SYSRES volume is not the OS/3 
REL volume, you must first transfer those modules to $Y$SRC on the OS/3REL volume 
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using the ADD statement of the system librarian, LIBS. There may be only one 
supervisor or ICAM network per module in $Y$SRC. In addition, an ICAM module name 
must match the ICAM name that you want to regenerate. 


The software maintenance routines do not regenerate EMULAT, NTR, or COBOL 
modules, nor do they regenerate information management systems (IMS) or data base 
management systems (DMS). However, do not regenerate these yourself unless the 
audit report directs you to do so. Remember that you must regenerate your IMS if the 
SMP program regenerates your ICAM network. 


The system maintenance realignment process copies the entire contents of your system 
load library (SY$LOD) and the system job control library ($Y$JCS) to temporary 
workfiles on the $Y$RUN disk to perform the realignment of the system files $Y$LOD 
and $Y$JCS. Therefore, if you are performing the SMP installation procedure to realign 
your SYSRES files, we suggest that you first obtain a listing of the contents of these 
files. By doing so, you can check that the SMP program leaves $Y$LOD and $Y$JCS 
complete and intact on your SYSRES when it finishes the realignment process. To 
obtain this listing, use the LISTRES job control stream that we describe in the system 
service programs user guide, UP-8062 (current version). To ensure that the realignment 
process works properly, never erase either of the system files that the process realigns, 
do not terminate the process once it starts, and run the realignment jobs in a 
completely dedicated machine environment. That is, do not run other jobs or enter any 
console commands such as the REBUILD command during realignment. These actions 
could cause errors during the realignment. 


11.2.3. Erasing SMP Files 


After installing an SMP, you can erase the SMCFILE, a file containing all the SMCs that 
are a part of an SMP, all the M$ files, and all back-out files by specifying option 7. The 
SMP program erases each of these files, updates the $Y$SMCLOG to indicate that 
back-out files no longer exist, and displays a message to tell you that the SMP job 
terminated normally. Do not erase these files, however, unless you are certain all SMCs 
in the SMP have been successfully installed, and you no longer want to retain the 
back-out capability. 


11.3. THE SMC INSTALLATION PROGRAM 


If at any time you require an SMC that is not yet part of an SMP, Sperry Univac will 
provide that change to you as soon as possible without waiting for the next SMP to be 
released. For this reason, we provide a separate SMC installation program, also 
described in this section. When you enter the command that calls the SMC program, 
the following options are displayed on your console or workstation screen. As we said, 
these options appear as a series of messages on the console screen but as a menu on 
the workstation screen. 
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SMC APPLICATION SCREEN 1 - PROCESSING OPTIONS MENU 


Apply. SMC in normal more (accept all defaults). 
Change normal defaults. 

Special processing. 

Perform supervisor regenerations. 

Perform ICAM regenerations. 

Perform system library realignment. 

Erase “SMCFILE’ and all backup and M$CO files only. 
Help - obtain additional information. 

Terminate with current changes. 


O ON O US WY = 


Enter selection number: _ ; Press TRANSMIT 


Press FUNCTION-F2 to cancel job. 


Figure 11-2. SMC Processing Options Menu 


As you can see, these options are identical to those offered by the SMP program with 
one exception, the special processing option (option 3), which is offered only when you 
run the SMC program. If you select special processing and press XMIT, the SMC 
program displays a screen to the workstation user, or a series of messages to the 
console user, which let you perform the following operations: 


= Install exception SMCs that apply to specific types of users. We recommend that 
you do not install them unless your Sperry Univac representative directs you to do 
SO. 


w #@ Install a subset of the SMCs in SMCFILE 
= @©Prevent installation of certain SMCs in the SMCFILE 


= Back out individual SMCs applied earlier to your system via the SMP or SMC 
program if they produce adverse effects on your system. A back-—out copy of the 
bad SMC must exist for you to perform this procedure and, again, don’t use this 
procedure unless directed by a Sperry Univac representative. 


If we supply the SMC to you over the phone or through the mail, you must build the 
SMC in the standard OS/3 change format yourself. The SMC installation program allows 
you to enter the changes from punched cards, disk, a workstation, or from the system 
console. If you elect to use a workstation, the SMC program initiates an interactive SMC 
entry process that helps you build the change module in the correct change format. If 
you have to use a console because your system does not include workstations, the 
SMC program initiates the SMC console dialog to help you build the change in the 
correct format. We recommend using the workstation as it provides more help facilities, 
but we'll show you how to use both methods later in this section. 
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The SMC installation program, by default, performs the same tasks as the standard 
SMP installation program. You can also direct the SMC program to perform additional 
regenerations or system file realignments should the need arise. Unless you know that 
the SMC installation program must perform either of these additional tasks for your 
particular situation, use the default procedure for installing an SMC. Otherwise, install 
the SMC without the default option so you can specify the additional tasks you want to 
perform. 


Figure 11-3 illustrates the installation of an SMC. 









SMC 
INSTALLATION 
PROGRAM 


SMC 
INPUT 
MEDIA 









Figure 11-3. Installation of an SMC 
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11.4. RUNNING THE SMP INSTALLATION PROGRAM 


The following subsections describe the procedure for running the SMP installation 
program to install an SMP or perform additional system maintenance tasks. 


NOTES: 


1. This procedure shows the processing screens you'll see when you enter the SMP 
run command at a workstation, and explains the choices offered by those screens 
and how you respond to them. You can also use this procedure to run the SMP 
program from the system console, but you must respond to console messages 
displayed by the program instead of screens. We'll present each of those 
messages immediately after the workstation screen that the message corresponds 
to. If you run the SMP program from the system console, you must answer the 
messages the program displays as follows: 


# Press the MSG WAIT key to position the cursor at the beginning of the next line. 


# Key in the option you want to perform and press XMIT. Your keyin must be in the 
format: 


mmAn 


where: 


mm 


Is the two character number of the console message you are responding 
to. 


Is the number of the option you want to perform. 


2. The time it takes to install an SMP depends on several factors including the number 
of SMCs in the SMP, the number of optional components your system contains, 
and whether you have already installed some of the SMCs in the SMP. Refer to the 
timing estimator form in the SMP document (SMPD) to estimate the time required 
to install an SMP to your system. 


To run the SMP program, proceed as follows: 


1. Perform an initial program load to load either the delivered supervisor, SYSMIX, or 
one you've generated yourself into main storage. For the IPL procedure, see the 
operations handbook, UP-8072 (current version). For the SMP _ supervisor 
generation requirements, see the SMPD which accompanies the SMP. 


2. Mount the SMP media. 
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3. At your workstation or system console, key in: 


RV ical 





where: 
INPUT= 
Describes the medium on which you are entering the SMP into your 
system. 
(T, vsn) 


Specifies the yolume serial number of a tape. 


(D,RES) 
Specifies that you dumped the contents of the SMP release tape to 
your SYSRES. 


modules affected by the SMP. 


4. Press the XMIT key. The SMP installation program displays messages to inform 
you that the OS/3 dump/restore and librarian facilities are copying the contents of 
the SMP media to your SYSRES to prepare for installation of the SMP. When 
dump/restore and the librarian complete the copy operation, the SMP job 
terminates, then reexecutes itself, and displays the following menu screen asking 
what type of processing you desire: 


SMP APPLICATION SCREEN 1 - PROCESSING OPTIONS MENU 


Apply SMP in normal mode (accept all defaults). 
Change normal defaults. 

Copy files from input media to RES pack only. 
Perform supervisor regenerations. 

Perform ICAM regenerations. 

Perform system Library realignment. 

Erase 'SMCFILE', all backup files, and M$ files. 
Help - obtain additional information. 

Terminate with current changes. 


OON O WU FWD = 


Enter selection number: _ ; Press TRANSMIT. 


Press FUNCTION-F2 to cancel job. 





SMP Processing Options Menu 
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NOTE: 


If you run the SMP program from the system console, these options appear as a series 
of messages that are scrolled up from the bottom of the screen. All of the options 
appear with the exception of option 8 because the SMP program provides help screens 
only to workstation users. 


5. Determine from the options listed on this screen which function you want to 
perform: | 


— if you want to install an SMP, go to 11.4.1. 


— tf you want to perform additional supervisor regenerations only, additional 
ICAM regenerations only, or realign SYSRES files only, go to 11.4.2. 


— if you want to erase files created by the SMP program after you have installed 
an SMP, go to 11.4.3. 


NOTES: 

1. To cancel the SMP job, press the FUNCTION key and F2 simultaneously. 

2. Options 1 and 2 on the SMP processing options menu are mutually exclusive to 
options 4, 5, and 6. Therefore, selecting option 1 or 2 after 4, 5, or 6, in the same 
run of the SMP job, cancels option 4, 5, or 6. And selecting 4, 5, or 6 after 1 or 2 
cancels option 1 or 2. However, options 4, 5, and 6 are cumulative. So you can 
enter any of these four options in the same SMP run without cancelling any of the 
four. 

11.4.1. Installing an SMP 

You can install an SMP either in normal mode and thus accept the default processing 

options we provide, or you can suppress the defaults and install an SMP with options 

you select yourself. 

= §=6To install an SMP in normal mode, go to step 1. 


= ~=6To install an SMP and change the defaults, go to step 2. 


1. Key in 1 and press XMIT. The SMP program initiates a series of jobs to accomplish 
the following tasks: 


— installs all the SMCs that apply to your system; 


— regenerates SYSMIX and the supervisor you loaded to install the SMP (if not 
SY$MIX) if the SMP affects its operation. 
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— regenerates the C1 ICAM symbiont if the SMP affects its operation. 
— prints an audit report of the status of all the SMCs installed to your system. 


When the SMP program completes these tasks, go to step 3. 


2. Key in 2 and press XMIT to install an SMP without the normal defaults. 


a. The installation program then displays the first of three additional processing 
screens, the supervisor regeneration screen (Figure 11-4): 











SMP/SMC APPLICATION SCREEN 3 - SUPERVISOR REGENERATION 


Regeneration of up to three supervisors may be performed only or at 
the end of the SMP/SMC installation. 


Do you wish to regenerate a supervisor: ___. YES/NO 












If you wish to do regenerations enter the names or prefixes (followed by 
a period) of the supervisor parameter source modules and press TRANSMIT. 





To regenerate a supervisor the module containing source code 
parameters must be available in SYSSRC. If an SMP has already 
been installed regenerated starter supervisions SY@BAS, SY@SMP 
(for SYSTEM 8@), and SYSMIX (for SYSTEM 9@) have been installed. 

Press FUNCTION-F1 to cancel screen and return to the master menu. 

Press FUNCTION-F2 to cancel job. 

FUNCTION-F13 for help information. 


Figure 11-4. Supervisor Regeneration Screen 


NOTE: 


The following messages are displayed to the console user: 


SMPQ3@ ENTER UP TO 3 SUPERVISOR NAMES, N: NO SUPVR REGEN, 
# SMPQ7® C: CANCEL JOB, OR M: RETURN TO MENU. DEFAULT: ipl'd supervisor 


Enter the source module names of the supervisors that you want to regenerate, or 
prefixes of those names followed by a period, and press XMIT. Remember that a 
supervisor cannot be regenerated by the SMP program unless the supervisor source 
module resides in $Y$SRC on your SYSRES. If a prefix is entered, all supervisor 
modules in $Y$SRC with that prefix will be regenerated. 
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Also, if you're a workstation user, notice the options that appear at the bottom of 
this screen as well as on each of the additional processing screens displayed by 
the SMP program. You select one of these options simply by pressing the 
FUNCTION key and simultaneously pressing the workstation function key that 
corresponds to the option you want to perform: 


FUNCTION — F1 Cancels the current screen and redisplays the processing 


options menu. Return to step 5 of 11.4 and select another 
option. 


FUNCTION — F2 Cancels the SMP job. 


FUNCTION — F13 Displays a help screen providing additional information about 
the choices on the current screen. 


NOTE: 


If you use the system console, you can return to the Processing Options Menu by 
entering an M and pressing XMIT or cancel the SMP job by entering a C and 
pressing XMIT. Help screens are not available to the console user. 


b. After you specify the supervisor modules you want to regenerate and press 
XMIT, the following screen (Figure 11—5) is displayed: 

















SMP/SMC APPLICATION SCREEN 4 —- ICAM REGENERATION 


Up to three ICAM regenerations may be performed only or at the end 
SMP/SMC installation. 


Do you wish to regenerate an ICAM: - YES/NO 


If you wish to do regenerations enter the names or prefixes (followed by 
a period) of the ICAM parameter source modules and press TRANSMIT. 





To regenerate an ICAM, the module containing source code 
parameters must be available in $SYSSRC. | 


Press FUNCTION-F1 to cancel screen and return to the master menu. 
Press FUNCTION-F2 to cancel job. 
FUNCTION-F13 for help information. 


Figure 11-5. ICAM Regeneration Screen 
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NOTE: 
The following messages are displayed to the console user: 


SMPQ3@ ENTER UP TO 3 ICAM NAMES. N: NO ICAM REGEN, 
# SMPQ7@ C: CANCEL JOB, OR M: RETURN TO MENU. DEFAULT:C1 


You can regenerate up to three ICAM symbionts by entering the ICAM source 
module names or prefixes of those names followed by a period, and pressing 
XMIT. As with supervisor regeneration, an ICAM symbiont cannot be regenerated 
by the SMP program unless the ICAM source module resides in $Y$SRC on your 
SYSRES. If a prefix is entered, all ICAM modules in $Y$SRC with that prefix will be 
regenerated. 


c. After you specify the ICAM modules you want to regenerate and press XMIT, 
the system file realignment screen (Figure 11-6) is displayed: 


SMP/SMC APPLICATION SCREEN 5 —- SYSTEM FILE REALIGNMENT 


Realignment of SY$JCS and $SY$LOD witl be done in this 
order. You may choose to realign only one of these files. 
To do this answer 'YES' or 'NO' to the following and press TRANSMIT. 


Realign SY$JCS? 


Realign SY$LOD? 


Press FUNCTION-F1 to cancel screen and return to the master menu. 
Press FUNCTION-F2 to cancel job. 
Press FUNCTION-F13 for help information. 





Figure 11-6. System File Realignment Screen 


NOTE: 


The following messages are displayed to the console user: 


SMPQ5® DO YOU WISH TO REALIGN $Y$JCS? ENTER YES, NO, 
# SMPQ7@ C: CANCEL JOB, OR M: RETURN TO MENU. DEFAULT: NO 


After you enter your response, these messages are repeated for $Y$LOD. 
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& You can direct the SMP program to realign the system files $Y$JCS and $Y$LOD 
simply by entering YES on the appropriate lines on this screen and then pressing 
XMIT. Realignment of these files recovers file space lost during SMP installation 
due to overwriting of modules and provides proper positioning of the most 
frequently used modules for improved system performance. : 


d. After you specify the realignments you want to perform and press XMIT, the 
processing options menu shown in Figure 11-1 is redisplayed. Key in 9 (or 8 if 
you re running the program from the system console) and press XMIT. The 
SMP program then: 


— installs all the SMCs that apply to your system; 
— performs any regenerations or realignments that you have specified; and 


— prints an audit report of the status of all the SMCs installed to your 
system. 


3. After installing an SMP, the SMP program displays messages to tell you: 
— whether the SMP was installed successfully; 
— that the SMP job is issuing a command to execute SMCLIST; and 
®@ — that the SMP job terminated normally. 


The SMP job leaves job slot 1 and SMCLIST takes its place. SMCLIST then provides a 
printout of the contents of SY$SMCLOG, which is a record of all the SMCs that have 
been installed in your system. When SMCLIST successfully prints this list, you receive a 
message informing you that SMCLIST has terminated normally. The SMP. installation 
process is now complete. 


NOTE: 


After you install an SMP, check the SMP document to see if the SMP requires that you 
update the system definition file, SYS$SDF. If so, see 10.8.1 for the procedure for 
updating loadable microcode. Also, check the audit trail printout for special notes about 
the SMP you just installed. 


4. Once the SMP installation is complete, perform an initial program load (IPL) to 
continue with your normal processing. For the IPL procedure, see the operations 
handbook, UP-—8072 (current version). 


NOTE: 


lf your system has any supervisors or any ICAM modules affected by the SMP (other 
than modules automatically regenerated as defaults) and you did not tell the SMP 

é program to regenerate them, be sure to regenerate them yourself before you load and 
use them. See Section 10 for the system generation procedure. 
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11.4.2. Performing Additional Regenerations or Realignments 


To perform additional regenerations or realignments after installing an SMP, proceed as 
follows: 


lf you want to perform additional supervisor regenerations, go to step 1. 
If you want to perform additional ICAM regenerations, go to step 2. 
lf you want to realign SYSRES files, go to step 3. 


Key in 4 and press XMIT to display the supervisor regeneration screen (or console 
messages). This screen is shown in step 2a of 11.4.1 along with an explanation of 
the processing options that appear at the bottom of the screen. Enter the 
supervisor modules you want to regenerate and press XMIT. The SMP program 
then redisplays the processing options menu. If you want to perform additional 
tasks, continue with step 5 of 11.4. Otherwise, key in 9 (or 8 if you‘re running the 
program from the system console), press XMIT, and go to step 4 of this 
procedure. 


Key in 5 and press XMIT to display the ICAM regeneration screen (or console 
messages). This screen is shown in step 2b of 11.4.1 and the processing options 
that appear at the bottom of it are explained in 2a of 11.4.1. Enter the ICAM 
modules you want to regenerate and press XMIT. The SMP program redisplays the 
processing options menu. If you want to perform additional tasks, go to step 5 of 
11.4. Otherwise, key in 9 (or 8 if you're running the program from the system 
console), press XMIT, and go to step 4 of this procedure. 


Key in 6 and press XMIT to display the system file realignment screen (or console 
messages). This screen is shown in step 2c of 11.4.1 and the processing options 
that appear at the bottom of it are explained in 2a of 11.4.1. Indicate whether or 
not you want to realign $Y$JCS and $Y$LOD and press XMIT. The SMP program 
redisplays the processing options menu. If you want to perform additional tasks, go 
to step 5 of 11.4. Otherwise, key in 9 (or 8 if you’re running the program from the 
system console), press XMIT, and go to step 4 of this procedure. 


After you supply this information, the SMP program performs the additional tasks 
that you specified, informs you when it has successfully done so, and displays 
messages to tell you: 


— that the SMP job is issuing a command to execute SMCLIST; and 


— that the SMP job terminated normally. 


The SMP job leaves job slot 1 and SMCLIST takes its place. SMCLIST then provides a 
printout of the contents of $Y$SMCLOG, which is a record of all the SMCs that have 
been installed in your system. When SMCLIST successfully prints this list, you receive a 
message informing you that SMCLIST has terminated normally. The SMP process to 
perform additional tasks is now completed. 


| ; 
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11.4.3. Erasing SMP Files 


After you install an SMP, you can direct the SMP program to erase the SMCFILE, all M$ 
files, and all back—out files. To do so, key in 7 and press XMIT. The program erases 
each of these files and updates the $Y$SMCLOG to indicate that back—out files no 
longer exist for any SMCs. The program then displays a message to tell you that the 
SMP job terminated normally. 


NOTE: 


Erase these files only if you no longer want to retain back—out capability for SMCs 
contained in the SMCFILE. Use the SMP program to erase SMP files as_ this 
automatically updates the $Y$SMCLOG to reflect this action. 


11.5. RUNNING THE SMC INSTALLATION PROGRAM 


The following subsections describe the procedure for installing SMCs that are not part 
of an SMP. 


NOTE: 


This procedure shows the processing screens you'll see when you enter the SMC run 
command at a workstation, and explains the choices offered by those screens and how 
you respond to them. You can also use this procedure to run the SMC program from 
the system console, but you must respond to console messages displayed by the 
program instead of screens. We'll present each of these messages immediately after 
the workstation screen that the message corresponds to. If you run the SMC program 
from the system console, you must answer the messages the program displays as 
follows: 


a Press the MSG WAIT key to position the cursor at the beginning of the next line. 


a Key in the option you want to perform and press XMIT. Your keyin must be in the 
format: 


mmAn 


where: 


mm 
ls the 2-character number of the console message you are responding to. 


Ils the number of the option you want to perform. 


1. Perform an initial program load to load either the delivered supervisor, SYSMIX, or 
one you've generated yourself into main storage, even if you are already operating 
under that supervisor. For the IPL procedure, see the operations handbook, 
UP—8072 (current version). 
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2. Mount the SMC media. If we delivered the change on keypunched cards, insert 
them in your card reader; if we supplied the change over the phone or through the 
mail, simply proceed with step 3. 


NOTE: 


lf you are entering more than one SMC on cards, you can combine the SMC decks and 
key in the SMC run command once to install all the SMCs in the combined deck. To do 
so, you must remove the //AFIN cards from the end of each SMC deck except for the 
last deck and insert a /* card immediately before the last //AFIN card. Then, put the 
combined deck in the card reader and key in the SMC run command as described in 
step 3. 


In addition, if you are entering one or more SMCs on cards and your system uses 
spooling, you must remove the //AFIN cards and insert a /* card, and then create a 
spool file containing the data in the card decks before you run the SMC program. To do 
that, insert the following card at the beginning of the deck: 


//DATAAFILEID=SMCREADER, , IGNORE 


Then, put this revised deck in the card reader and enter IN at your system 
console/workstation in console mode. Your system will create the spool file containing 
the data in your card deck. When it has successfully done so, you receive the message 
SPOOLFILE SMCREADER WAS CREATED and you can proceed with step 3. 


3. Key in: 

RV SMCI, ff INPUT=/C len! 
CR N 
(D,RES) 
(D,vsn) 
(CR,vsn) 
(T,vsn) 
WS 

where: 

INPUT 


Describes the medium on which you are entering the SMC into your 
system. If you run the SMC program only to perform supervisor or ICAM 
regenerations or to realign system files (without installing an SMC), you 
can omit this parameter. 


Note that the INPUT parameter does not describe the device at which 
you're running the SMC program. There is a difference: You can be 
running the SMC program from your workstation, but be inputting the 
SMC through any of the media described in the following list. 
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INPUT=C 
Specifies you will build the SMC in the correct change format using the 
SMC console dialog at the system console. Choose this method if you 


received the SMC over the phone or through the mail but do not have 
workstations in your system. 


INPUT=CR 


Specifies the card reader. Specify this choice if you received the SMC on 
cards or if you have keypunched the cards yourself. 


NOTE: 


If you keypunch the SMC yourself, be sure that on card 2, you start the 
// OPTION SMC card in Column 30 and include only one space after the 
slashes and the word option. Otherwise, you will get errors. 


INPUT=(D,RES) 
Specifies that the SMCs to be installed reside in the SMCFILE on SYSRES. 


INPUT=(D,vsn) 


Specifies that the SMCs to be installed reside in the SMCFILE on the disk 
pack with the specified volume serial number. 


INPUT=(CR,vsn) 


Specifies the volume serial number of a diskette to be used as card reader 
input. 


INPUT=(T,VvSsn) 


Specifies that the SMCs to be installed reside on a tape with the specified 
volume serial number. 
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& INPUT=WS 


Specifies that you will build the SMC in the correct change format using 
the interactive SMC entry process at the workstation. Choose this method 
if you received the SMC over the phone or through the mail. 


B=N 
specify this optional parameter only if you do not want the SMC job to create 
permanent back-out files. 

NOTE: 


If you specify INPUT=C, proceed with step 6. If you specify INPUT=WS, proceed 
with step 7. Otherwise, go to step 4. 


4. Press the XMIT key. The SMC program displays the following menu screen asking 
what type of processing you desire: 


SMC APPLICATION SCREEN 1 - PROCESSING OPTIONS MENU 


Apply SMC in normal mode (accept all defaults). 
Change normal defaults. 

Special processing. 

Perform supervisor regenerations. 

Perform ICAM regenerations. 

Perform system library realignment. 

Erase 'SMCFILE' and all backup and M$CO files only. 
Help - obtain additional information. 

Terminate with current changes. 





1. 
2. 
D's 
4. 
as 
6. 
re 
8. 
rae 


Enter selection number: _ ; Press TRANSMIT. 


Press FUNCTION-F2 to cancel job. 





NOTE: 


lf you run the SMC program from the system console, these options appear as a 
series of messages that are scrolled up from the bottom of the screen. All of the 
options appear with the exception of option 8 because the SMC program provides 
help screens only to workstation users. 


The options on this screen are identical to those on the SMP processing options 
menu and are described in 11.4, with the exception of the special processing 
option (option 3), which is offered only when you run the SMC installation program. 


Determine from the options listed on this screen which function you want to 
perform: 





— if you want to install an SMC, proceed to part a of this step; 


— if you want to perform additional supervisor regenerations, additional ICAM 
regenerations, or realign SYSRES files, proceed to part b of this step; 
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— if you want to erase files created during SMC installation, proceed to part c of _ 
this step; 


— if you want to perform one of the special processing operations, proceed to 
part d of this step. 


NOTE: 


Options 1 and 2 on the SMC processing options menu are mutually exclusive 
to options 3, 4, 5, and 6. Therefore, selecting option 1 or 2 after 3, 4, 5, or 
6, in the same run of the SMC job, cancels option 3, 4, 5, or 6. And selecting 
3, 4, 5, or 6 after 1 or 2 cancels option 1 or 2. However, options 3, 4, 5, and 
6 are cumulative. So you can enter any of these four options in the same SMC 
run without cancelling any of the four. 


a. You can install an SMC either in normal mode and thus accept the default 
processing options we provide or you can suppress the defaults and 
install an SMC with options you select. Regardless of which mode you 
choose, the SMC program operates in the same way as the SMP program 
described in 11.4. Refer to that section if you do not understand the 
options offered by the SMC program. 


= To install an SMC in normal mode, key in 1 and press XMIT. The 
SMC program: 


installs the SMC to your system; 


— regenerates SY$MIX and the supervisor you loaded to install the 
SMC (if not SY$MIX) if the SMC affects its operation; 


— regenerates the C1 ICAM symbiont if the SMC affects its 
operation; and 


— prints an audit report of the status of all the SMCs installed to 
your system. 


When the SMC program completes these tasks, go to step 5. 


= #$To install an SMC without the normal defaults, key in 2 and press 
XMIT. 


The installation program then displays three additional processing 
screens (or equivalent console messages): the supervisor regeneration 
screen, the ICAM regeneration screen, and the system file realignment 
screen. These screens are shown in 11.4.1 and the processing 
options they offer are also explained in that section. If you need help 
answering these screens, refer to 11.4.1 or simply press_ the 
FUNCTION key and simultaneously press F13 to display a help screen. 


NOTE: 


The SMC program does not provide help screens to console users. 
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Fill in the first processing screen (or respond to the console 
messages) and press XMIT to display the second screen. Repeat the 
process for the second screen, and so forth. After you have 
answered all three screens, the SMC processing options menu is 
redisplayed. Key in 9 (or 8 if you're running the program from the 
system console), and press XMIT. The SMC program then: 


— installs the SMC; 


— performs the regenerations or realignments that you have 
specified; and 


— prints an audit report of the status of all the SMCs installed to 
your system. 


When the SMC program completes these tasks, go to step 5. 


b. 


To perform additional regenerations or realignments, proceed as follows: 


— To perform supervisor regenerations, key in 4 and press XMIT to 
display the supervisor regeneration screen (or equivalent console 
messages). Enter the supervisor modules you want to regenerate and 
press XMIT. The SMC program then redisplays the processing 
options menu. Key in 9 (or 8 if you're running the program from the 
system console), press XMIT, and go to step 5 of this procedure. 


— To perform ICAM regenerations, key in 5 and press XMIT to display 
the ICAM regeneration screen (or equivalent console messages). Enter 
the ICAM modules you want to regenerate and press XMIT. The SMC 
program then redisplays the processing options menu. Key in 9 (or 8 
if you're running the program from the system console), press XMIT, 
and go to step 5 of this procedure. 


— To perform realignments, key in 6 and press XMIT to display the 
system file realignment screen (or equivalent console messages). 
Indicate whether or not you want to realign $Y$JCS and/or $Y$LOD 
and press XMIT. The SMC program then redisplays the processing 
options menu. Key in 9 (or 8 if you're running the program from the 
system console), press XMIT, and go to step 5 of this procedure. 


After you install an SMC, you can direct the SMC program to erase the 
SMCFILE, all M$ files, and all back-out files. To do so, key in 7 and press 
XMIT. The program erases each of these files and updates the 
$YSSMCLOG to indicate that back-out files no longer exist for any SMCs. 
The program then displays a message to tell you that the SMC job 
terminated normally. 


To perform one of the special processing options, key in 3 and press the 
XMIT key. The SMC program then displays the following screen (Figure 
11-7): 


UP-8074 Rev. 11 SPERRY UNIVAC OS/3 11-22 
SYSTEM INSTALLATION Update A 


SMC APPLICATION SCREEN 2 - SPECIAL PROCESSING 
(1) EXCEPTION (2) SELECTED (3) EXCLUDE (4) BACKOUT 


Enter the number of this type of processing to be performed. 


Enter the numbers of the SMCs to be processed: 


FUNCTION-F1 to cancel screen and return to master menu. 
FUNCTION-F2 to cancel job. 
FUNCTION-F13 for help information. 





Figure 11-7. SMC Special Processing Screen 


NOTE: 
The following messages are displayed to the console user: 
# Primary request: 


SMPQ2@ SPECIAL PROCESSING OPTIONS ARE: 

SMPQ21 (1) EXCEPTION (2) SELECTED (3) EXCLUDE (4) BACKOUT 
SMPQ22 ENTER NUMBER OF THE TYPE OF PROCESSING TO BE DONE 
SMPQ7@ C: CANCEL JOB, OR M: RETURN TO MENU. DEFAULT: 1 


@ Secondary request: (displayed after you respond to the primary 
request by selecting one of the special processing options) 


SMPQ23 (n) ENTER UP TO 6 SMC NUMBERS, E: END OF INPUT, 
SMPQ7@ C: CANCEL JOB, OR M: RETURN TO MENU. DEFAULT: 1 


Messages SMPQ23 and SMPQ/70 are repeated up to three times (as 
indicated by nj, provided that six valid SMC numbers are entered for the 
current query. E can be entered for query SMPQ/70O if no more entries are 


desired. 7 @ 
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Select one of the four operations offered on this screen (Figure 11-7). 
The response and criteria for each selection follow: 


— to install exception SMCs, key in 1. The SMC job then displays the 
following message: ENTER UP TO 6 SMC NUMBERS, E:END OF 
INPUT,C:CANCEL JOB, OR M:RETURN TO MENU? Respond to this 
message by keying in the numbers of the exception SMCs to be 
installed and press the XMIT key. If you key in less than six, the SMC 
job redisplays the SMC processing options menu. If you have more 
than six, the message is redisplayed up to three times for you to 
enter more. When you have no more exception SMC numbers to 
enter, respond M so the SMC job returns you to the SMC processing 
options menu. On the SMC processing options menu, key in 9 (or 8 if 
you re running the program from the system console), press XMIT, 
and proceed to step 5. (Exception SMCs apply only to certain types 
of users, and you should not install them unless directed to do so by 
your Sperry Univac representative.) 


— to install a subset of the SMCs in the SMCFILE, key in 2 and enter 
the numbers of the SMCs to be processed on the lines provided. 
Then, press the XMIT key to redisplay the SMC processing options 
menu. Key in 9 (or 8 if you're running the program from the system 
console), press XMIT, and proceed to step 5. 


— to prevent the installation of certain SMCs in the SMCFILE, key in 3 
and enter the numbers of the SMCs to be excluded. Then, press the 
XMIT key to redisplay the SMC processing options menu. Key in 9 
(or 8 if you're running the program from the system console), press 
XMIT, and proceed to step 5. 


— to back-out bad SMCs, key in 4 and enter the numbers of the SMCs 
to be backed out. Then, press the XMIT key to redisplay the 
processing options menu. Key in 9 (or 8 if you're running the program 
from the system console), press XMIT, and proceed to step 5. 


5. After you install an SMC or perform additional tasks, the SMC program displays 
messages to tell you: 


— whether the SMC was installed successfully; 


— that the SMC job is issuing a command to execute SMCLIST; and 
— that the SMC job terminated normally. 


The SMP job leaves job slot 1 and SMCLIST takes its place. SMCLIST then provides a 
printout of the contents of $YS$SMCLOG, which is a record of all the SMCs that have 
been installed in your system. When SMCLIST successfully prints this list, you receive a 
message informing you that SMCLIST has terminated normally. The SMC installation 
process is now complete. 
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6. Press the XMIT key. Because you specified INPUT=C on your SMC execution 
command, the SMC job initiates the SMC console dialog to build the change in the 
standard OS/3 change format. We provide a sample SMC in the correct change 
format at the end of this section (Figure 11-12). It shows the parts of the change 
that Sperry Univac provides and the information you must provide in response to 
the SMC console dialog queries. If you received the SMC over the phone, your 
Sperry Univac representative must supply all the information you need to answer 
the dialog queries. Respond to the dialog queries in the following manner. 


NOTE: 


lf, at any time in the current dialog session, you respond incorrectly to a dialog 
query, key in CANCEL, press the XMIT key, and respond Y for yes to the 
subsequent message PROCESS ANOTHER SMC (Y OR N)?. The SMC dialog ignores 
all your previous responses, both correct and incorrect, and redisplays the dialog 
Starting at step a so that you may enter correct responses. 


a. When the message ENTER SMC NUMBER (XXXXXXxX): appears, key in the 
7-character SMC number and press the XMIT key. 


b. When the message ENTER COMPONENT NUMBER (XXXxX): appears, key in the 
4-character component number and press the XMIT key. 


c. When the message ENTER APPLIES-TO RELEASE LEVEL (XXXXXxX): appears, 
key in the release level that the SMC applies to and press the XMIT key. You 
must key in the release level as a 6-digit number. For example, release 8.0 
would be 080000. 


d. When the message ENTER PRODUCT TYPE NUMBER (XXXX-XX): appears, 
key in the 6-character, hyphenated product type number and press the XMIT 
key. If you write SMCs yourself, the product type number must be specified as 
USER-xx, where xx are any sequential digits. 


e. When the message ENTER SYSTEM CODE (9=S/90, 8=S/80, C=COMMON): 
appears, key in the appropriate system code found in the job control we 
provide and press the XMIT key. 


f. When the message ENTER REGEN FLAGS (XXXXXXXX): appears, check the 
REGEN specification in the job control we provide. Key in Y for yes, or N for 
no, for each of the eight fields in the specification, in exactly the way that we 
provide it. The REGEN flags identify the types of regenerations required as a 
result of installing this SMC. Each field contains a value, either Y or N, that 
tells whether regeneration is required or not required for each type of module 
your system could include. The eight fields in the value correspond to: 
supervisors, ICAM networks, NTR networks, emulation modules, ANSI ‘74 
COBOL compiler modules, IMS modules, and DMS modules (the eighth field 
identifies any other modules affected by this SMC and explained in line 13 of 
the job control we provide). For example, installation of the sample SMC in 
Figure 11-12 requires no regenerations because all 8 REGEN flags show N for 
no. 
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g. When the message REQUIRED SMCs? (XXXXXXX,...MAX=5): appears, key in 
up to five 7-character SMC numbers of prerequired SMCs and press the XMIT 
key. If there are no required SMCs, simply press the XMIT key. 


h. When the message ENTER CHARACTER TO REPRESENT LEADING SPACE 
appears, key in any character on your keyboard that is not included in the 
actual SMC. This character must be keyed in in steps i and j, which follow, as 
a substitute for leading spaces in any change lines requiring them. If you don't 
specify a character, you must use the left bracket ([). 


NOTE: 


The first time the messages in steps i and { appear, 32 will occupy the field 
XX because line 32 of an SMC is the first line of the actual change and the 
first line you must key in. Each successive time these messages appear, the 
number in the field XX will increase by one until you key in LAST to tell the 
SMC program you have no more change lines to key in. 
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i. When the message ENTER LINE XXX COLS 1 TO 60 appears, you can either 
continue entering the SMC at the console or you can use the card reader as 
the input device for the remainder of the SMC. 


(1) 


(2) 


To use the card reader, enter the letters CR in response to the ENTER 
message and press XMIT. The card deck should contain the SMC 
preceded by a // JOB card and followed by a /*. Then, continue with step 
k of this procedure. 


If you continue using the console, respond to the ENTER message by 
keying in the first 60 columns of the following parts of each line of the job 
control for the SMC, then press the XMIT key. You must provide 
(including slashes): 
m DVC-LFD sequences of any files that the SMC affects; 
= execute statement for whatever system program that the SMC 
executes. The SMC could execute one of the following system 
programs to change the corresponding program module: 
— LIBS — execute LIBS to correct the SAT module; 
- TRNPAT — execute TRNPAT to correct the system transient file; 
— MLIB — execute MLIB to correct the system MIRAM module; and 
— MSGGEN — execute MSGGEN to correct the system message file; 
a /$ 


m any parameters associated with the system program you are 
executing; and 


| i? 


lf you have no more change lines, key in LAST, press the XMIT key and 
proceed with step k. 


j. When the message ENTER LINE XXX COLS 61 TO 80 appears, key in the last 
20 columns of the information requested in step i and press the XMIT key. If 


your entire change line fits on the first 60 columns, press the XMIT key and 
go back to step i. 


k. When the message ACCEPT THIS SMC (Y OR N)? appears: 


check your responses to all of the previous queries; 


key in Y for yes and press the XMIT key if they are all correct and 
proceed with step |; key in N for no and press the XMIT key if any are 
incorrect. This response causes the entire SMC to be disregarded and 
displays the message: PROCESS ANOTHER SMC (Y or N)?. 
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|. When the message PROCESS ANOTHER SMC (Y OR N)? appears, key in Y for 
yes if you need to define another SMC and go back to step 6; key in N for no 
if you have no other SMCs to define and go back to step 4. 


7. Press the XMIT key. Because you selected INPUT=WS on the SMC execution 
command, the SMC job initiates the interactive SMC entry process to build the 
change in the standard OS/3 change format. We provide a sample SMC at the end 
of this section (Figure 11-13). It shows both the parts of the SMC that Sperry 
Univac provides and the information you must fill in the blanks on the interactive 
SMC entry screens. These screens include blanks for many fields in an SMC. Some 
are required; some are optional. On the SMC entry screens in Figures 11-9 and 
11-10, we show ail of the fields you could fill in — both required and optional 
information. On the sample SMC at the end of this section, we show only those 
fields that you are required to fill in. If any fields on the entry screens start blinking 
after you press the XMIT key, you have not supplied the necessary information for 
those fields. in that case, re-enter the data for those fields, position the cursor at 
the bottom of the screen, and press the XMIT key. If you received the SMC over 
the phone, your Sperry Univac representative must supply all required information 
you'll need to use this process. Perform the interactive SMC entry process in the 
following manner. 


NOTE: 


If at any time during this process you want to terminate the SMC job, press the 
FUNCTION key and F1 simultaneously. 


a. The following screen (Figure 11-8), which contains an explanation of the 
interactive SMC entry process and instructions for using the workstation, is 
displayed. After you read this screen, press the XMIT key to continue with the 
SMC entry procedure. 


INTERACTIVE SMC ENTRY INSTRUCTION SCREEN [01] 


THE FOLLOWING SCREENS WILL REQUEST INFORMATION REQUIRED TO BUILD AN 
SMC IN OS/3 FORMAT. JUST ENTER THE REQUESTED INFORMATION BY FILLING 
IN THE BLANKS. YOU MAY TAB OVER FIELDS TO ACCEPT ANY DEFAULT VALUES. 


A DATA FIELD WILL BLINK TO INDICATE THAT INVALID INFORMATION HAS’ BEEN 
ENTERED OR’ THAT A FIELD WHICH REQUIRES INFORMATION TO BE ENTERED WAS 
LEFT BLANK. JUST TAB TO THE BLINKING FIELD AND OVERWRITE IT WITH 
THE CORRECT INFORMATION. 


WHEN YOU HAVE COMPLETED A SCREEN, PRESS THE XMIT KEY TO CONTINUE WITH 
THE NEXT SCREEN. AFTER COMPLETING THE TWO FORMAT SCREENS YOU WILL BE 
REQUESTED TO ENTER THE PATCH CARDS. 


YOU MAY ELECT TO START OVER AT ANYTIME BY PRESSING FUNCTION KEY 1 [F1]. 


PRESS CXMIT] TO CONTINUE OR, [F1] TO TERMINATE. <_> 





Figure 11-8. SMC Instruction Screen 
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© b. The first interactive SMC entry screen (Figure 11-9) is displayed. Fill in the 
required fields on this screen: 






INTERACTIVE SMC ENTRY SCREEN (03] 
, 11900, 14000 X ! $01 


// OVC 20 // LFD PRNTR // OPTION SMC 14560062 





















s// NOP KKEKKAKKRERKREKEKEKEEKKEKEKKEREREREKEKEREKERREERRKKRERRKKEREKER \FFFFO@O3 
\// NOP CORRECTION IS FOR. -— ————s—s—‘—‘“‘ié‘i;i ! 04 
$// NOP IT WAS SUBMITTED ON —___ AND IS. st 1 _ 005 
\// NOP IT APPLIES TO RELEASE _—_—| THRU | ____ 006 
‘// NOP IT IS ___ TESTED AND IS ___ FIELD VERIFIED 907 












! 

! 
'// NOP THE SUR ORIGINATED IN !____ 008 
4// NOP CORRECTION HAS BEEN APPLIED TO RELEASE _.._._ 1 ___ 909 
4// NOP IT IS INCLUDED IN !____019 
}// NOP COMPONENT SOURCE IS CORRECTED IN RELEASE _____ ! 11 
4// NOP CONTINGENCY: SYSTEM=_ REGEN= _. !____@12 
NOE tere ce eee !____013 
$// NOP FIXES SURS: _ !_ 014 
$// NOP REQUIRED COR: XXXX,XXXX,XXXX, XXXX, XXXX t_ 615 
4// NOP REPLACES COR: XXXX,XXXX,XXXX,XXXX, XXXX ! 016 


PRESS [XMIT] TO CONTINUE OR, [F1] TO START OVER. <_> 





Figure 11-9. First SMC Entry Screen 


c. Press the XMIT key to display the second SMC entry screen shown in Figure 
11-10. Fill in the required fields on this screen: 


INTERACTIVE SMC ENTRY SCREEN [04] 


"IS REQUIRED BY CORS: XXXX,XXXX,XXXX, XXXX, XXXX 

‘IS REPLACED BY CORS: XXXX,XXXX,XXXX, XXXX, XXXX 
‘CORRECTION REQUIRES ____ WITH VSN MODULE=_ 
‘(FILEID= 


"ECN=NONE ! 
“MODULES CORRECTED: " 17040028 


! 029 


“CORRECTION CARD COUNT: | 4 030 


"KH KKKKKKKEKHKKKEKKEKEKEEKEEKK KEKE KKKKKKEKKRKKKKEK 1F0O01031 


PRESS [(XMIT] TO CONTINUE, OR [(F1] TO START OVER. <_> 





Figure 11-10. Second SMC Entry Screen 





UP-8074 Rev. 11 SPERRY UNIVAC OS/3 11-28 
SYSTEM INSTALLATION Update B 


d. Press the XMIT key. If you have made any errors on either of the entry 
screens, a warning message is displayed giving the number of the line 
containing the error. Should this occur, check the line to verify that you entered 
it correctly. , 


At this point, the workstation screen is cleared and an editor-like mode is provided 
for entering the remainder of the change. Multiple spaces are not required when 
entering an SMC. Therefore, hash information may be entered one space after the 
last data character on a line. 


When the line number prompt appears, key in the first line of the actual SMC and 
press the XMIT key. Continue to enter all the lines of the actual SMC, pressing the 
XMIT key after each one. You must enter the complete SMC as shown. If any lines 
are omitted you will receive an error message. 


lf you have no more change lines, either press FUNCTION and the F2 key 
simultaneously, or enter the word LAST and press the XMIT key. Proceed with 
part e. 


e. When the message ACCEPT SMC (Y,N) OR CMD (P, U OR HELP): appears, 
check your previous entries, then: 


— if all entries are correct, key in a Y (for YES) and press the XMIT key. 
Proceed with part f; or 


— if the SMC is not in acceptable format , you may be abie to correct it with 
the SMC editor — a facility we provide to make SMCs easier to prepare. 
Entering the command HELP and pressing the XMIT key displays the 
editing commands help screen shown in Figure 11-11: 



























, | 
2 EDITING COMMANDS HELP SCREEN [01] 

3 

4 The command request expects that you will enter the letter of a command 
5 and then press the red [(XMIT] key. 

6 

7 Some of the commands require a line number (indicated by the ‘#° symbol 
8 following the command explanation below), which should be supplied with 
9 the command letter. 





SYNTAX COMMAND 
Y Yes 
A No 






P#H 
U# 





For a more detailed explanation of any command, just enter it's letter here <x> 
and press the [XMIT] key, otherwise just press (F1}], [F2] or the [(XMIT] key. 


Figure 1 1-11. Editing Commands Help Screen 
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2 To perform one of the functions listed on this screen, simply enter the first letter of 
: that function and press the XMIT key. The following functions should be particularly 
helpful to you in editing an SMC: 


P(rint) Displays the SMC on the workstation screen. You can supply a 
line number with this command in the format Pxxx (where xxx is 
the starting line number, of up to three digits, of the line to be 
displayed). If no line number is supplied, the entire SMC is 
displayed. The SMC is scrolled up from the bottom of the screen 
until either the last line has been displayed or you decide to halt 
the display by pressing FUNCTION and F17 simultaneously. To 
continue the display, press FUNCTION and F19 simultaneously. If 
at any time you want to end the display, press FUNCTION and 
F18 simultaneously. 


U(pdate) Displays the requested line and allows it to be changed. You 
must supply a line number with this command in the format Uxxx 
(where xxx is the line number, of up to three digits, you want to 
update). If you do not supply a line number with the command, a 
prompting message is displayed. When you use the update 
function to change a line, make sure you erase the has sequence 
(Innnnnnn) in columns 73 to 80 before you press the XMIT key. 
If you update a line without deleting the has information, you will 
e encounter a hash total error. 


After you perform one of the editing functions, press the XMIT key to redisplay the 
ACCEPT message and return to part e. 


— if the SMC cannot be corrected, enter N (for NO) and press the XMIT key. 
This response restarts the interactive SMC entry process beginning with 
part a of this step. 


f. When the message DO YOU WISH TO PROCESS ANOTHER SMC? (Y OR N): 
appears, key in Y (for yes) and go back to step 7 if you want to build another 
SMC. Otherwise, key in N (for no) and go to step 4. 


The following sample (Figure 11—12) shows an SMC in the correct change format. 
It shows the parts of the change that Sperry Univac provides and also the 
information you must fill in the blanks on the interactive SMC entry screens. These 
screens include blanks for many fields in an SMC. Some are required; some are 
optional. On the SMC entry screens in Figures 11-9 and 11-10, we show all of 
the fields you could fill in — both required and optional information. Here, on this 


sample SMC, we show only those fields you are required to fill in. They are the 
shaded fields. 
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// 
// 
// 
// 
// 
// 
Me | 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 


EGHISS2, 7000, 14000 x 
DVC 20 // LFD PRNTR // OPTION SMC 
NOP SHKRKKEKEKRKEKEKEKEKKEKKKEKKKKKKKKKKKKKEKKKRKKRKEKKKKKKKKKKKKKRKKKKKKK KKK KKK 





NOP ‘CORRECTION IS FOR @#4@-DUMP FACILITY SYSDUMP-JOBDUMP ' 
NOP ‘IT WAS SUBMITTED ON C83182 AND IS REQUIRED 083182 
NOP ‘IT APPLIES TO RELEASE $8888% THRU 089099 
NOP ‘IT IS TESTED AND Is NOT FIELD VERIFIED ‘6270-68 

NOP ‘THE SUR ORIGINATED IN FIELD ! 
NOP ‘CORRECTION HAS BEEN APPLIED TO RELEASE XX.X.X ' 
NOP ‘IT IS INCLUDED IN 
NOP ‘COMPONENT SOURCE IS CORRECTED IN RELEASE 09.0.0 ' 
NOP ‘CONTINGENCY: SYSTEM=€. REGEN=NNNNNNNN 
NOP ! 
NOP ‘FIXES SURS: 029484 
NOP ‘REQUIRES COR: KRM NXXK, RMKK, RRKK KEKE 
NOP ‘REPLACES COR: XXXX,XXXX,XXXX,XXXX,XXXX 
NOP ‘IS REQUIRED BY CORS: XXXX,XXXX,XXXX,XXXX,XXXX 
NOP ‘IS REPLACED BY CORS: XXXX,XXXX,XXXX,XXXX,XXXX 
NOP ‘CORRECTION REQUIRES WITH VSN MODULES=N 
NOP ‘(FILEID= ) ' 
NOP ‘CORRECTION DESCRIPTION: 
NOP ‘MISSING PUB IN SYSDUMP PUBS INTERPRETATION 
NOP ! 
NOP ! ! 
NOP ! 
NOP ! 
NOP 'ECN=C075562 
NOP ‘MODULES CORRECTED: 
NOP 'SYSDMP 














// NOP ‘CORRECTION CARD COUNT: 044 ! 
7] NOP GG III III IIIT TTA II AIS IASI IAA III III 1 
// OVC 20 // LFD PRNTR 
// €X€C LIBS 
/$ 
FIL D1=$Y$LOD 
BOG CSSYSTEM,D1 
COR OD1,L,SYSDMP 
-12B4,40,45BOC1EC 
-145C ,40,9120303B07 1B4B70C3E807FB 
EOD 
EOG CSSYSTEM,D1 
/* 
/& 
// FIN 


Figure 11-12. Sample SMC — Required Fields for SMC Console Dialog 
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1D822001 
14650002 
'FFFFOO3 
19997004 
12714005 
1A53A006 
!ABF 2007 
13013008 
!92FCOO9 
17075010 
14903011 
'E7FB@12 
12020013 
10059014 
1'C866015 
1€160016 
1D990017 
1D406018 
'82CEO19 
1A404020 
19299021 
1E8E9O22 
!1F 20023 
11F1F O24 
11F1E@25 
11F 10026 
11805027 
17040028 
1835B029 
1B38A030 
1F001031 
13FF5032 
1BDO@5033 
18817034 
1C€3CD035 
!CA60036 
!1EACO3?7 
1CCD2038 
16699039 
10061040 
1C€975041 
187 1A942 
18700043 
11920044 
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ate 






























t 2, ,7000, 14000 1D822001 
// DVC 20 // LED PRNTR // OPTION SMC 14650002 
// NOP CHEK KKK KKEKEKKKK KEKE EKKERKKEKKKEKE 'FFFFQOS 
// NOP ‘CORRECTION IS FOR -DUMP FACILITY SYSDUMP - JOBDUMP ' 10997004 
// NOP ‘IT WAS SUBMITTED ON C83182 AND IS REQUIRED 983182 ' 12714005 
// NOP ‘IT APPLIES TO RELEASE THRU ' 1A53A006 
// NOP ‘IT IS. ~-TESTED AND IS NOT FIELD VERIFIED ' 1 ABF2007 
// NOP 'THE SUR ORGINATED IN FIELD ' 13013008 
// NOP ‘CORRECTION HAS BEEN APPLIED TO RELEASE ' 192FCO09 
// NOP ‘IT IS INCLUDED IN ' 17075010 
// NOP ‘COMPONENT SOURCE IS CORRECTED IN RELEASE 09.0.0 ' 14903011 
// NOP ‘CONTINGENCY: ih ' 1E7FBO12 
// NOP ! ' 12020013 
// NOP ‘FIXES  SURS: ' 10059014 
// NOP ‘REQUIRES COR: ' 16866015 
// NOP ‘REPLACES COR: XXXX.x ' 10160016 
// NOP 'IS REQUIRED BY CORS: ' 10990017 
// NOP 'IS REPLACED BY CORS: XXX XXXX,X) XX ' 1D406018 
// NOP ‘CORRECTION REQUIRES WITH VSN MODULES=N ' 182CE019 
// NOP '(FILEID= ) ' 1A404020 
// NOP ‘CORRECTION DESCRIPTION: ' 10299021 

' 1E6E9022 
| 11620023 
' 1 1E1F 024 
' 116 1E025 
' 11F1D026 
// NOP 'ECN=C075562 ' 11BD5027 
// NOP ‘MODULES CORRECTED: | ' 17040028 
1B35B029 
1B38A030 
1FD01031 

1 3FFS032 
'BD05033 
18617034 
1C3CD035 
1CA6D036 

! 1EACO37 
'CCD2038 
16699039 
1D001040 
1C975041 
1871A042 
18700043 
11020044 





Figure 11-13. Sample SMC — Required Fields for Interactive SMC Entry from Workstation 
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Appendix A. Statement Conventions 


The conventions used to delineate the configuration parameter values in this manual are: 


a Parameter definition is by keyword association. Keyword parameters consist of a word 
or a code immediately followed by an equal sign, which in turn, is followed by a 
specification. Keyword parameters can be written in any order except where 
restrictions are noted. Keyword parameters may be written in columns 1 through 71. 
More than one keyword parameter may be included on the same statement, but they 
must be separated by at least one blank character. Except for some parameters, 
which we explain later, keywords and their specifications must be contained on the 
same statement. 


Special rules for coding ICAM network definition keywords and macros are described 


in 6.2.1. 

Examples: 
PRIORI TY=5 
PRIORI TY=5 JOBSLOTS=3 T I MER=MAX 
PRIORI TY=5 T 1 MER=MAX JOBSLOTS=3 


= Capital letters, commas, equal signs, and parentheses must be coded exactly as 
shown. The exceptions are acronyms, which are part of the generic terms 
representing information to be supplied by the programmer. 


Examples: 


SUPMOD=supvrnam 
COMM=2 , 18 
CACH=(nn,CCA-name,!tine-number ) 


m Lowercase letters and words are generic terms representing information that must be 
supplied by the user. Such lowercase terms may contain hyphens and acronyms (for 
readability). 


Examples: 
channel 


supervisor-name 
vsn 
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# Information contained within braces represents alternate choices of which only one @ 
may be coded. 


Examples: 


MAX 
MIN 
NO 
NORM 


2 Information contained within brackets represents optional entries that (depending 
upon program requirements) are included or omitted. Braces within brackets signify 
that one of the specified entries must be chosen if that parameter is to be included. 


Examples: 


{SUPMOD=supvrnam] 
SUPVRNAM= f[supervisor-name 
SYSSTD 


= An optional parameter that has a list of alternate entries may have a default 
specification that is supplied by the operating system when the parameter is not 
specified by the user. Although the default may be specified by the user with no ae 
adverse effect, it is considered inefficient to do so. For easy reference, when a default _ 
specification occurs in the format delineation it is printed on a shaded background. If, 
by parameter omission, the operating system performs some complex processing 
other than parameter insertion, it is explained in an “if omitted” sentence in the 
parameter description. 


Examples: 


Pee a isor-name 


= Keyword parameters may contain sublists called subparameters. Subparameters may 
be positional or nonpositional, as indicated in the text. Subparameters must be 
separated by commas. 





- Positional subparameters must be coded in the order shown, and commas must 
be retained for any that are omitted, with the exception of trailing commas. 


Examples: 


SYSOUT=DSP881.8414, PARTIAL 
SYSOUT=DSP081,8414 
SYSOUT=vsn, ,NOPREP 


SYSOUT=,, PARTIAL @ 
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- Nonpositional subparameters may be coded in any order on a single statement 
and separated by commas. (A comma is not required after the equal sign.) In the 
special cases where all subparameters do not fit on one parameter statement, 
that statement can exceed one line, providing you repeat the keyword parameter 
and its equal sign for each additional line that you need. Remember that this rule 
does not apply for parameters that fit on one line; in those cases, every keyword 
parameter and its specifications must be on one line. 


Examples: 


RESMOD=SMS$ASCKE, SM$ATCH, SM$SDBS ,SM$GTPUT, SM$LOCK, SM$LOD, SMSSTXIT,SMSTASK 


This list of nonpositional subparameters will not fit on one statement line; 
therefore; what you must do is code it on two lines like this: 


RESMOD=SMSASCKE,SMS$ATCH, SM$DBS ,SM$GTPUT, SM$LOCK,SMS$LOD, SM$STXIT 
RESMOD=SM$TASK 


The label entry must begin in column 1. 


Example: 


Label AOperationA 


SUPGEN 
END 


= The assembler coding form (UD1-1548) is recommended for coding of the SYSGEN 
keyword parameters, since the LABEL, OPERATION, and OPERAND field limits are 
illustrated. 


Keyword parameters must not appear on the following label parameter cards: 


SUPGEN 
1/OGEN 
RESGEN 
EMULAT 
COMMCT 
NTRGEN 
COBGEN 
END 
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Index 
Term | Reference Page Term Reference Page 
A B 
Account number, SPOOLMODE Backup copy, OS/3REL and SYSRES 1.4 1-10 
parameter 2.2 2-20 10.4 10-6a 
10.8.6 10-52 
Adding supervisor 9.5 9-6 
BAL assembler, RESGEN 42 4-5 
ADDR keyword parameter 3.3.1 3-9 
BASIC compiler modules 42 4-5 
Allocated cylinders, SPOOLCYL 
parameter 2 9-17 Basic supervisor generation example 9.2 9-] 
Alternate stacker fill (ALTSTACK) 3.3.3 3-15 Batch system environment | 1-1 
10.7.1 10-17 
Alternate transient file (ATRANS) 42 4-8 
Baud rate 6.2.2 6-8 
AMOUNT keyword parameter 3.3.8 3-20 
BEM compiler modules, RESGEN 42 4-5 
ASCII mode, reader keyword 
parameter 3.3.3 3-15 Binary coded decimal (BCD), TRANSLAT 
keyword parameter 3.3.6 3-19 
Assembler coding form Appendix A 
Bit map calculation, spool file Table 2-1 2-18 
Asynchronous line speeds Table 6-1 6-9 
BLKSIZE keyword parameter 7.2.2 7-7 
ATTNRE keyword parameter 3:1 3-11 
Block numbered tapes, TAPEBLKNO 
Automatic dialing (autodial), CACH parameter 2.2 2-14 
parameter 6.2.2 6-8 
BLOCKIN keyword parameter 7.2.1 7-5 
AXNON keyword parameter 8.2 8-4 
| BLOCKOUT keyword parameter 7.2.1 7-5 
AXREF keyword parameter 8.2 8-4 
Boot block records, SG$PREP 1.3.1 1-5 
Automatic operation, parameter 
processor 10.7.2.3.1 10-32 BPOOLEXP keyword parameter 6.2.2 6-1] 
BPSX routine | 6.2.2 6-11 


© | Bulletin, system, changing 10.8.4 10-50 


Burst mode output spooling, SPOOLBURST 2.2 2-18 


UP-8074 Rev. 11 


Term 


CA 


CACH keyword parameter 
CALL statements, SUPGEN 
CALLST keyword parameter 
Card size, FEED keyword parameter 
Cardless system installation 
Cartridge name, SPOOLMODE parameter 
CATVSN keyword parameter 
CCAMOD keyword parameter 
existing network definition 


format 


CDI data management mode 


CDIMODE, keyword parameter 
CDMIO keyword parameter 
CHAN keyword parameter 


Changing parameter sets 
batch 
interactive 


CHARSET keyword parameter 
CMCSST keyword parameter 


COADDR keyword parameter 
disk 
tape 


COBGEN 
coding example 
description 
flowchart 
format 
generation procedure 
keyword parameters 
SYSGEN procedure phase 


COBOL compiler, RESGEN 








SPERRY UNIVAC OS/3 
SYSTEM INSTALLATION 


Reference Page Term 


COCHAN keyword parameter 


disk 
See communications tape 
adapter. | 
Coding examples 
6.2.2 6-6 emulator configuration 


ICAM configuration 
22 9-14 label parameters 
multiple supervisors 


8? 8-4 RESGEN label parameters 
system generation (SYSGEN) 
3.3.3 3-14 
COMM keyword parameter 
10.7 10-17 
Comma conventions 
Le 2-20 
COMMCT 
4? 4-9 communications configuration 
ICAM load module 
ICAM network 
6.212 6-5 parameter definitions 
6] 6-2 section flowchart 
SYSGEN procedure phase 
2.2 2-26 
4? 4-5 Common keyword parameters, |/OGEN 
4.2 4-5 
82 g-4 Common data interface (CDI) 
3.3.1 3-8 Communications 
capability (COMM keyword) 
COMMCT format 
10.7.1.3 10-19 COMMCT parameters 
10.7.2.3 10-31 


Communications adapter (CA) 
33.2 3-13 CACH keyword parameter 
PIOST keyword parameter 


8.2 8-4 a 

Communications control areas (CAA) 
identification 

3.3.5 3-17 parameters 

3.3.6 3-18 supervisor, ICAM generation 
COMPRESS keyword parameter 

1.4.1 1-14 

8] 9-1 Concurrent jobs, JOBSLOTS parameter 

Fig. 8-1 8-2 . 

8} 8-2 Configuration parameter 

10.7.1.10 10-25 cards, SYSGEN responsibilities 

8.2 8-4 sets 

1.4.1 1-12 values, delineation 

4? 4-6 CONPRINT keyword parameter 


index 2 
Update B 


Reference 


3.3.5 
3.3.6 


1.4.1 
1.4.1 
1.4.1 
1.4.1 
1.4.1 
Section 9 


2.2 


Appendix A 


6.1 

1.4.1 

9.3 

6.2 

Fig. 6-1 
1.4.1 


2.2 
6.1 
6.1 


6.2.2 
6.2.2 


6.2 
6.2.1 
9.3 
7.2.2 


2.2 


1.4.1 
1.4.3 
Appendix A 


rae 


Page 
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Term 


Console printer (COP) 
I/OGEN device label, format 
specifying system console printer 


Consolidated data management (CDM) 
CONSOLOG keyword parameter 
Control storage code (COS) 

keyword parameter 

modifying OS/3REL volume 


SGSASG 
SYSGEN procedure 


Copy to disk 
any disk (COPYREL/SETREL) 
same disk (DCOP) 


Copying OS/3 release tape to 
OS/3REL volume 


Copying/restoring $Y$SDF 
COPYREL system utility 
Correcting parameter sets 
batch 
interactive 
CPYTXT keyword parameter 


CREATE diskette utility 


Cylinder size, library file, RESGEN 


SPERRY UNIVAC OS/3 
SYSTEM INSTALLATION 


Reference Page Term 
D 

3.1 3-2 
3.4 3-208 Data base management system (DMS) modules 
8.2 8-4 Data cards, parameter presentation 
2.2 2-23 Data management mode keyword parameter 

Data utility modules, RESGEN 
4.2 4-9 
10.8.3.1 10-49 DAYCHANGE keyword parameter 
1.3.1 1-5 
1.4.2.1 1-15 

DCOP met 
10.7.1.2 10-18 aad 

DDP (distributed data processing) 

RESGEN modules 

10.4.1 10-7 SUPGEN 
10.4.2 10-13 

DDPSPOOL keyword parameter 
10.2 10-2 Debugging program, SYSDUMP parameter 
10.8.2 10-48a Default specification 

device dependent, new 1/0 

10.4.1 10-7 statement conventions 
10.4.1.3 10-10 SYSGEN operation, initiation 

ELETE k 
vere 10-19 DELETE keyword parameter 
10.7.2.3 10-31 DENSITY keyword parameter 
8.2 8-5 DESPACE keyword parameter 
10.7 10-17 
‘9 Fae Device category, 1/OGEN 


Device function codes 
DEVICE keyword parameter 


Device label parameters 
logical unit numbers 
type, common keyword parameter 


Device type, SPOOLMODE parameter 
DIAG keyword parameter 


Diagnostic 
emulator output listing 
I/OGEN output listing 
ONLNDIAG parameter 
Supervisor generation 
warning code, SUPGEN 





Index 3 
Update B 


Reference 


42 


72 
42 
2.2 
10.4.2 
42 
2.2 
2.2 
2.2 
3.3 
Appendix A 
1.4.1 
4.2 
3.3.6 


3.3.7 
3.3.8 


3.1 

Table 7-2 
7.2.2 
Table 3-1 
3.3.1 

2.2 


8.2 





Page 


1-12 
4-5 


3-19 
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Term 


DIAGWN keyword parameter 
Dial adapter, subchannel 


Dialog processor 


Dialog specification translator, RESGEN 
Disk format, 1/OGEN 

DISK keyword parameters 

Disk type/vsn, RESGEN 

Diskette format, I/OGEN 
DLOADBUFR keyword parameter 
DLOADTABLE keyword parameter 
DMGTMODE keyword parameter 
DIF data management mode 
DTFFOR4 

DUALTRAN keyword parameter 
Duplicated parameter, SUPGEN 
DVCNO keyword parameter 


Dynamic buffer management 
keyword parameter (DYNBUFMGT) 


Dynamic buffer pool expansion 
routine (BPSX) 


Reference Page 
8.2 8-5 
6.2.2 6-8 
1.3 1-4 
1.3.2 1-] 
42 4-6 
3.1 3-6 
3.3.5 3-17 
42 4-4 
3.1 3-6 
2.2 2-14 
2.2 2-14 
2.2 2-26 
2.2 2-26 
10.8.7 10-52 
3.3.3 3-15 
2.1 2~l 
3.3.1 3-11 
22 2-2] 
6.2.2 6-11 
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SYSTEM INSTALLATION 


Term 


EBCDIC mode 
reader keyword parameters 
tape keyword parameters 


Editor modules, general, RESGEN 


Emulator 
coding example 
configuration generation 
creation of load module 
description 
flowchart 
format 
EMULAT label 
load modules, RESGEN 
SYSGEN procedure phase 
tape loop definition 


END statement, delimiter, supervisor 
generation 


End-of-file keyword parameter (EOF) 
End-of-number code (eon) 

ERRLOG keyword parameter 
ERRLOGBUF keyword parameter 

Error diagnostics, parameter processor 
ESCORT compiler modules, RESGEN 


Examples, SYSGEN 
adding a supervisor 
basic supervisor generation 
duplicating supervisor generation 
ICAM network 
label parameters 
NTR generation 
statement conventions 
SYSGEN coding methods 
tailored SYSRES, batch 
tailored SYSRES, interactive 


Expanded character set 

EXPREGION keyword parameter 

Extended compiler COS code 
COBOL 


FORTRAN 
RESGEN parameters 


Index 4 


Reference 


3.3.3 
3.3.6 


4.2 


1.4.1 
10.7.1.7 
5.2 

5:4 

Fig. 5-1 
5.1 

5.1 


1.4.1 
14.1] 


2.1 


Appendix A 
1.4.1 

9.3 

9.4 


3.322 
2.2 
10.8.3.1 


10.8.3.1 
4.2 
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Index 5 





Term 


FASTLOAD keyword parameter 
FEED keyword parameter 
FILELOCK keyword parameter 
RESGEN 
SUPGEN 


Files, SYSGEN, deleting from 
release volume 


Filename, SPOOLMODE parameter 
FIPS keyword parameter 

FLOATPT keyword parameter 

Font set, printer parameter, 1/OGEN 
Form name, SPOOLMODE parameter 


Format, keyword parameter 


FORTRAN compiler, RESGEN 
FORTRAN installations 


Fragmented regions, main storage, 
MEMCONSOL keyword parameter 


FULL option, SYSOUT parameter, RESGEN 
FUNCD keyword parameter 


Function codes, NTR 


General editor 
modules, RESGEN 
0S/3 


Group name, RESHARE parameter 


Reference Page 


6.2.2 6-11 
3.3.3 3-14 
42 4-9 
22 213 
10.8.3.2 10-50 
ra 2-20 
8.2 8-5 
Le 2-13 
3.3.2 3-13 
fa 2-20 


See keyword 
parameter format. 


42? 4-6 
10.8.7 10-52 
22 2-10 
42 4-4 
7.2.2 7-8 
Table 7-2 7-8 
42 4-6 


10.7.2.2 10-26 


Term 


Hardware 
address, common keywords 
floating-point 
microprogramming, SYSGEN procedures 


Help screens, SYSGEN dialog 


IBM 360/20 emulator 
emulator generation 
RESGEN modules 
SYSGEN phases 


ICAM module 
configuration examples 
existing definition 
generation 
new definition 
RESGEN 
SPOOLICAM keyword parameter 
SYSGEN phases, COMMCT 
symbiont table update 


IGNORESFT keyword parameter 
legal keyword parameters 
IMS load module 

COS code 

RESGEN parameters 
IMSCOD keyword parameter 


IN keyword parameter 


INCLUDE keyword parameter 


Reference 


3.3.1 
1.4.2.1 


Laie 


Page 


10-24 


10-49 
4-7 


8-5 


4-5 





UP-8074 Rev. 1] SPERRY UNIVAC OS/3 Index 6 
SYSTEM INSTALLATION Update B 
Term Reference Page Term Reference Page 
Information management system (IMS) J 
multithread modules 42 4-] 
single-thread modules 4.2 4-7 Job account 
number (JOBACCTREQ) 2.2 2-24 
Initial program load (IPL) routines (JOBACCT) 2.2 2-23 
copying, SG$PREP job stream 1.3.1 1-5 
SYSGEN procedures 10.7.1.2 10-18 Job control language 1.3 1-4 
Initialize system, SYSGEN operating Job control streams, system-supplied 1.3.1 1-4 
procedures 1.4.4 1-17 _ 
10.7.1.2 10-18 Job priority 
basis, SPOOLMODE parameter 2.2 2-19 
Input readers, SPOOLING parameter 2.2 2-15 levels, basic supervisor generation 9.2 9-1 
input/output device configuration (I/OGEN) Job streams, SYSGEN operating 
description 3.1 3-1 procedures 10.7.1.4 10-20 
format 3.1 3-4 
new 1/0 configuration 3.3 3-8 Jobname, SPOOLMODE parameter 2.2 2-20 
previous 1/0 configuration 32 3-8 
section flowchart Fig. 3-1 3-3 JOBACCT keyword parameter 2.2 2-23 
Supervisor generation 2.1 2-1 
SYSGEN procedure phase 1.4.1 1-11 JOBACCTREQ keyword parameter 2.2 2-24 
Installation verification (IVP) 10.8.5 10-52 JOBQUEREC keyword parameter 2.2. 2-24 
42 4-] 
JOBSLOTS keyword parameter 2.2 2-8 
Installing optional OS/3 products 10.3 10-3 
Integrated devices 
disk adapter 3.3.1 3-9 
peripheral channel 3.3.1 3-8 
Integrating software 1.4.2 1-14 
Interactive SMC entry sample Fig. 11-13 =11-31 
Interactive system generation 10.7.2 10-25 
| | K 
Interactive services keyword parameters 
ISADMID 2.2 2-29 KATAKANA keyword parameter 3.3.] 3-19 
ISBATCHLMT 2.2 2-28 
3.3.8 3-20 
ISINTLMT 2.2 2-28 
ISINTPRI 2.2 2-28 Keypunch configuration deck, SYSGEN 
ISKEYS 2.2 2-29 operation 1.4.1 1-12 
ISLOGONSC 2.2 2-29 
Keyword association Appendix A 
INTERACTIVE keyword parameter 2.2 2-26 
Keyword parameter format 
1/OMOD keyword parameter 3.2 3-8 COBGEN 8] 3-9 
. COMMCT 6.1 6-2 
Island code subroutine (SM$STXIT) 2.2 2-10 common 331 3-8 
EMULAT 5.1 5-1] 
1/OGEN 3.1 3-4 
NTRGEN 7.1 ]-3 
RESGEN 41 4-3 
SUPGEN 2.2 2-3 








UP-8074 Rev. 11 SPERRY UNIVAC OS/3 index 7 
SYSTEM INSTALLATION 
Term Reference Page Term Reference Page 
L M 
Label parameters Main storage, small 9.2 9-] 
coding examples 1.4.1 1-12 
entry conventions Appendix A Maintenance, system Section 11 
See also SMC and SMP. 
LCB keyword parameter 3.3.2 3-13 : 
Mandatory entries, statement conventions Appendix A 
LFD keyword parameter 7.2.2 7-9 
: Manual dialing, CACH parameter 6.2.2 6-8 
Library file | 
cylinder sizes 4.2 4-9 Manual operation, parameter processor 10.7.2.3.2 10-38 
modifyting OS/3REL volumes 10.8.3 10-49 
system supplied L331 1-5 MAP keyword parameter 8.2 8-6 
transferring L3e1 1-5 
MAXTIME keyword parameter 2.2 2-10 
LIN keyword parameter 8.2 8-5 
MAXTYPE keyword parameter 2.2 2-10 
LINE 
keyword parameter Lied 7-5 MCPNAME keyword parameter 6.2.2 6-6 
macroinstruction 6.2.2 6-7 MCPVOL keyword parameter 6.2.2 6-6 
Line speed values Table 6-1 6-9 MEMCONSOL keyword parameter 2.2 2-10 
LINESP keyword parameter 7.2.1 7-5 Menu services modules, RESGEN 42 4-] 
Linkage changes, SM$STXIT subparameters 2.2 2-12 Message control program (MCP) 
COMMCT format 6.1 6-2 
Linker, editor modules, RESGEN 4.2 4-7 keyword parameters 6.2.2 6-5 
load modules 9.7 9-/ 
LIST keyword parameter 8.2 8-6 new network definition 6.2.1.1 6-5 
LNKCON keyword parameter 8.2 8-6 Microcoding 
loadable microcode 10.8.1 10-40 
Load code buffer (LCB) SYSGEN procedures 1.4.2.1 1-15 
job control statements system initialization 1.4.4 1-17 
(QWNLC1, OWNLC2) 10.6 10-15 
printer keyword parameter 3.3.2 3-13 Misstated parameters, supervisor generation 2.1 2-1 
LOCAL keyword parameter | 7-1 Mixed data management mode 2.2 2-26 
7.2.2 7-] 
MIXFOR4 10.8.7 10-52 
Lock functions, SM$LOCK subparameter 2.2 2-11 
MODE keyword parameter 
Logical tracks, SPOOLMAP parameter 2.2 2-17 reader 3.3.3 3-15 
tape J: 3-18 
Logical unit numbers Table 3-1 = 3-11 
Mode settings 
LSTREF keyword parameter 8.2 8-6 9-track Table 3-2 -18 
7-track Table 3-3 = 33-18 
LSTWTH keyword parameter 8.2 8-6 
Module name, RESHARE parameter 2.2 2-25 
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Term 


— Multijobbing 
capabilities, PRIORITY parameter 
environment, SYSGEN procedures 


Multiple disk keywords, channels and 
addresses 


Multiple supervisors 
coding examples 
generation 
1/OGEN 
restriction 


Multiplexer channel, common keyword 
parameters 


Multitasking environment, RESMOD 
parameter 


Multithread modules 
MXNON keyword parameter 


MXREF keyword parameter 


N 


Name, supervisor, !/0 configuration 
NET keyword parameter 
Network definition 

description 

keyword parameters 


New 1/0 configuration 


New output volume, RESGEN examples 


New release level 
SYSGEN initialization 
upgrading operating system 
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Reference 


2.2 
1.4.2.2 


3.3.5 


14.1 


3.1 
Fig. 2-1 


7.2.1 


6.2.1 
6.2.2 


1.4.4 
1.4.2.2 


Page 


Term 


New supervisor 
I/O configuration, previous 
SYSGEN operating procedures 
SYSGEN with previous 1/0 


New user, integrating system software 


Nine thousand remote system (NTR) 
See also NTRGEN. 


Nonburst mode output spooling, 
SPOOLBURST parameter 


NOPREP option, RESGEN parameters 
NPRTSPnn keyword parameter 
NRZI mode, tape keyword parameters 
NTR function codes 
NTR keyword parameters 
NTR load module 

example 

generating 
NTRGEN 

format 

keyword parameters 

NTR module 

parameter definitions 

section flowchart 

supervisor 

SYSGEN procedure phase 
NTRMOD keyword parameter 
NTRNAME keyword parameter 


NTRVOL keyword parameter 


index 8 


Reference 


Siz 
10.7 
9.5 
14.2.1 


Section 7 


3.3.6 
Table 7-2 
7.1 

7.2.1 


9.7 
10.7.1.9 


7.1 

7.2.1 
1.4.1 
Fig. 7-1 
7.1 

1.4.1 
7.2.1 
7.2.1 


7.2.1 


Page 


3-8 
10-17 
9-6 


1-14 
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Index 9 





SYSTEM INSTALLATION Update B 
Term Reference Page Term Reference Page 
O P 
OB) keyword parameter 8.2 8-6 PAGOVF keyword parameter 8.2 8-] 
OBJLST keyword parameter 8.2 8-6 Parameter deck preparation 
batch 10.7.1.1 10-17 
OBJMOD keyword parameter 8.2 8-7 interactive 10.7.2.2 10-26 
Online maintenance load modules, RESGEN Parameter processor operation 
control system 4? 4-7 automatic execution 10.7.2.3.1 10-32 
communications 4? 4-7 manual execution 10.7.2.3.2 10-38 
ONLNDIAG keyword parameter 29 9-12 PARTIAL prep option, SYSOUT keyword 42 4-4 
Operating control language modules (OCL) 4.2 4-7 Phase encoded mode, tape keyword 
parameters 3.3.6 3-19 
Operating supervisor choice 10.5 10-14 | 
Physical 1/0 channels, common keywords 3.3.1 3-8 
Optional 
entries /parameter Appendix A PIOST keyword parameter 6.2.2 6-11 
products, 0S/3 10.3 10-3 
Post-SYSGEN procedures 10.8 10-40 
Options, system devices 3.1 3-1 nee 
Preemptive priority, ROLLOUT parameter 22 2-14 
0S/3 release volume (OS/3REL) ; 
backup copy 1.4 1-10 Prefiled SYSGEN job stream 
10.4 10-6a operation 10.7.2.4 10-39 
modifying library files 10.8.3 10-49 
SUPGEN 92 9-] Previous 1/0 configuration 
SYSGEN procedures 1.4.1 1-11 example 9.5 9-6 
SYSGEN simplified 1.3 1-4 /OMOD 3.2 3-8 
new supervisor 3.2 3-8 
OS/4 modules, RESGEN 42 4-7 
Previous supervisor 
Output writers, SPOOLING parameter 2.2 2-15 example 9.6 9-6 
SUPMOD keyword parameter 2.2 2-] 
OWNLC1/OWNLC2 load code buffer 10.6 10-15 . 
Print band characteristics definition 10.6 10-14 
OWNVFI, vertical format buffer 10.6 10-15 
| Print buffer requirements 
defining printer characteristics 10.6 10-14 
SG$PRB job control stream 1.3.1 ]-/ 
SYSGEN procedures 1.4.2.1 1-16 
Printer format, 1/OGEN 31 3-4 
Printer keyword parameters 33:2 3-13 
PRINTPOS keyword parameter 3.3.2 3-13 
PRIORITY keyword parameter 2.2 2-8 
Procedures, SYSGEN 10.7 10-17 
Program debugging, SYSDUMP parameter 2.2 2-10 
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Term 


PROVER keyword parameter 
PRPnnCOS routine 

PRTSPnn keyword parameter 
Punch format, 1/OGEN 


Punch keyword parameters 


Reader format, {/OGEN 
Reader keyword parameters 
READ/PUN keyword parameter 
Real devices 


Recording modes, tape keyword 
parameters 


Recording mode settings 
9-track 
7-track 


RECOVERDS keyword parameter 
Release level, SYSGEN procedures 


Release volume, deleting SYSGEN 
files 


Remote printer keyword parameters 
(REMPRINTER) 


Remote workstation keyword parameters 
(REMWORKSTATION) 


Renaming the supervisor, SUPVRNAM 
RESBUFSIZE keyword parameter 


RESGEN 
coding example 
description 
flowchart, section of SYSGEN 
format 
keyword parameters 
SYSGEN procedure phase 


Reference 


8.2 
10.4.1.2 


bed 


3.3.4 


3.3.6 
Table 3-2 
Tabie 3-3 
2.2 


1.4.2.2 
10.8.3.2 
3.3.9 


3.3.8 


1.4.1 
4} 

Fig. 4-1 
4] 

4.2 

1.4.1 
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Page 


2-26 


1-16 


10-50 


3-20a 


Term 


RESHARE keyword parameter 
Resident dup routine, SYSDUMP 
Resident macros, RESMOD 
Resident shared load modules (RESHARE) 
Resident spool file bit map 
RESMOD keyword parameter 
Restoring/copying $Y$SDF 
Restrictions 
multiple supervisor generation 
SUPGEN keyword parameters 
RETAINLOG keyword parameter 
ROLLOUT keyword parameter 
RPG Il modules, RESGEN 
RUN command 
RUNVSN keyword parameter 


RV command 


SAM 
modules, RESGEN 
parameter, keyword 


SCDINDEX keyword parameter 


Screen format generator modules, 
RESGEN 


SCRENMEM keyword parameter 
SEEKSEP keyword parameter 
SELACC keyword parameter 


Selector channels 1 and 2, common 
keywords 


SFT statements, IGNORESFT 
parameter 


Index 10 
Update B 


Reference 


10.8.2 


Fig. 2-1 
22 


4.2 
ya 


3.3.8 
3.3.5 


3.3.0 


33st 


2.2 


Page 


2-25 
2-10 
2-11 
2-25 
2-1] 
2-11 


10-48a 


1-18 
2-12 


1-18 


3-20 
3-17 


3-1/7 


2-25 
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Term 


SETREL system utility 


SG$ASG job control stream 
description 
execution 


SG$BLD job control stream 
description 
execution 
SGS$CATCP 
description 
execution 


SG$COBMK job control stream 
description 
execution 


SGS$COMMK job contro} stream 
communications configuration 
description 
operating procedures 


SGSEMJCL job control stream 
description 
emulator 
operating procedures 


SGSEMUMK job control stream 
description 
emulator/tape loop 
SYSGEN operating procedures 


SG$LIB job control stream 
description 
execution 


SG$LIB2 job control stream 
description 
execution 


SG$LIB3 job control stream 
description 
execution 


SGSNTRMK job control stream 
description 
operating procedures 


SG$PARAM job control stream 
description 
emulator 
operating procedures 


SG$PRB job control stream 
description 
operating procedures 
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Reference Page 


10.4.1 


1.3.1 
10.7.1.5 


1.3.1 
10.7.2.2 


Ida) 
10.7.1.5 


13] 
10.7.1.10 


6.1 
3.1 
10.7.1.8 


1.3.1 
Jel 
10.7.1.7 


13:1 
9.2 
10.7.1.7 


13.1 
10.7.1.5 


1.3.1 
10.7.1.5 


1.3.1 
10.7.1.5 


1.3.1 
10.7.1.9 


1.3.1 


10.7.1.3 


es Al 
10.6 


10-7 


[5 
10-21 


10-28 


1-] 
10-23 


Le} 
10-25 


6-1 
1-7 
10-24 


9-1 
10-24 


1-6 
a3 
10-24 


Ta3 
10-23 


1-6 
10-23 


1-6 
10-23 


1-7 
10-25 


1-5 
9-3 
10-19 


1-] 
10-16 


Term 


SG$PREP job control stream 
description 
execution 
SG$SCR job control stream 
SGS$SUPMK job control stream 
description 
execution 
operating procedures 
SGSTRANS job control stream 


description 
execution 


SHAREDMGT keyword parameter 
Single-thread modules 
SITE keyword parameter 
SMC (system maintenance change) 
console dialog, required fields 
description 
installation 
operation 
workstation, interactive entry 
SMP (system maintenance package) 
description 
erasing files 


installation 


operation 
performing additional tasks 


SM$ASCKE module 
SM$ATCH module 
SM$DBS module 

SM$GTPUT module 
SM$LOCK module 
SM$LOD module 

SM$STXIT module 


SM$TASK module 


Software modules, RESMOD parameter 


Sort/merge modules, RESGEN 


Index 11 


Update B 


Reference 


1.3.1 
10.7.1.5 


10.8.3.2 


1.3.1 


10.7.1.5 
10.7.1.6 


sa 


10.7.1.5 


2.2 


42 


Fig. 11-12 


lll 
11.3 
115 


Fig. 11-13 


11 
11.2.3 
11.4.3 
11.2 
11.4.1 
11.4 
11.2.2 
11.4.2 
2.2 
2.2 
2.2 
2.2 
2.2 
2.2 
2.2 
2.2 
rae 


4.2 


Page 


1-5 
10-20 


10-50 


1-5 
10-22 
10-24 


1-5 
10-18 


4-7 


7-5 


11-30 
11-1 
11-7 
1-17 
11-31 


11-1 
11-7 
11-17 
11-2 
11-11 
11-9 
11-6 
11-16 
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Term 


Space compression characters 
Specific devices, unit numbers 
SPERRY UNIVAC 9200/9300 emulator 

emulator generation 

SYSGEN phases 
Spool-file bit map 
SPOOLBUFR keyword parameter 
SPOOLBURST keyword parameter 
SPOOLCOMP keyword parameter 
SPOOLCYL keyword parameter 
SPOOLCYLn keyword parameter 
SPOOLFARS! keyword parameter 
SPOOLHDR keyword parameter 
SPOOLICAM keyword parameter 
SPOOLNOINPUT keyword parameter 
Spooling 

emulator 

keyword parameter 

main storage requirements 

modules, RESGEN 
SPOOLMAP keyword parameter 
SPOOLMODE keyword parameter 
SPOOLOWBUFR keyword parameter 
SPOOLPRT keyword parameter 
SPOOLRECV keyword parameter 
SPOOLTEST keyword parameter 
SPOOLUPDATE keyword parameter 
SPOOLVSN keyword parameter 


SPOOLVSNn keyword parameter 


SPRLST keyword parameter 
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Table 7-1 
3.3.1 
Table 3-1 
5.1 

1.4.1 
Table 2-1 
22 

2.2 

2.2 

2.2 

2.2 

2.2 

2.2 

2.2 

2.2 

5.1 

2.2 

2.2 

42 

2.2 

2.2 

2.2 

2.2 

2.2 

2.2 

2.2 

2.2 

2.2 


8.2 


Page 


/-] 


Term 


SPROUT keyword parameter 


Stacker-select keyword parameter 
(STACKSEL) 


Starter supervisor 

initial program load 

print band characteristics 
Start-up task processing, SM$ATCH 
Statement conventions 
Supervisor 

coding examples 

configuration parameters (SUPMOD) 

generation (SUPGEN) 

1/0 MOD name 

NTRGEN 

operating choice 

Starter 

SUPVRNAM parameter 
SUPMOD keyword parameter 
SUPVRNAM keyword parameter 
Surface analysis, RESGEN 
Switched network facilities 
Symbiont loader technique 
Symbiont table update, ICAM 
SYMBPRI keyword parameter 
Synchronous line speeds 
SYNCHK keyword parameter 
SYSDUMP keyword parameter 


SYSGEN files, deleting from 
release volume 


SYSGEN procedures 
batch system generation 
interactive system generation 


SYSLOG keyword parameter 
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Reference 
8.2 

3.3.4 
1.4.2.1 
10.6 

2.2 
Appendix A 
Section 9 
2.2 
Section 2 
3:2 

7.1 

10.5 

10.6 

2.2 

22 

2.2 


42 


10.8.8 

2.2 

Table 6-1 
8.2 


2.2 


10.8.3.2 


10.7.1 


10.7.2 


2.2 
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8-7 


2-7 
3-8 
2 
10-14 
10-14 
2-8 
i 
« @ 
4-4 
6-9 
6-6 
10-53 


2-15 
8-7 
2-10 
10-50 


10-17 
10-25 
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Term 


SYSOUT keyword parameter 
RESGEN 
SYSGEN operating procedures 


SYSRES 

System 
activity monitor, SAM 
bulletin, changing 
crash, SYSDUMP 


devices, |/OGEN 
software integration 


System console printer (COP) parameter 


SYSTEMDATE keyword parameter 


System definition file ($Y$SDF) 


System definition utility (SDU) 


System generation 
batch 
interaction 


System initialization, SYSGEN operation 
System job control stream library 
files ($Y$JCS) 
System librartes 
adding/overriding cylinder sizes 
modifying 
SG$ASG job control stream 
SG$LIB job control stream 
System load library file ($Y$LOD) 
cylinder size 
SGSSUPMK job control stream 
SYSRES creation 
System macro library ($Y$MAC) 


System maintenance 
See also SMC and SMP. 


System microcode file ($Y$MiC) 
System object library file ($Y$OBJ) 


System release document (SRD) 


Reference 


42 
10.7.1.6 
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10-24 


See system resident. 


Term 


System resident (SYSRES) volume 


System source library file ($Y$SRC) 


System-supplied program modules 


backup 

description 

examples 

flowchart 

format 

keyword parameters 


tailored pack generation 


cylinder size 


existing network definition 


1/0 configuration 


System/3 modules, RESGEN 


System/32 modules, RESGEN 


2.2 2-24 
10.8.4 10-50 
2.2 2-10 
3.1 3-2 
1.4.2 1-14 
3.1 3-2 
3.4 3-20a 
2.2 2-10 
10.8.1 10-40 
10.8.2 10-48a 
10.8.1 10-40 
10.7.1 10-17 
10.7.2 10-25 
1.4.4 1-17 
Section 10 

42 4-10 
42 4-10 
10.8.3 10-49 
1.3.1 1-5 
1.3.1 1-5 
42 4-9 
1.3.1 1-5 
4) 4-]} 
42 4-10 
Section 11 

10.8.1 10-40 
42 4-10 
1. 1-1 


Tape format, 1/OGEN 
TAPE keyword parameters 
Tape loop definition, load modules 
EMULAT 
SGSEMUMK 
TAPEBLKNO keyword parameter 
TASK keyword parameter 


Task priority levels, PRIORITY 
parameter 


TASKNAME keyword parameter 


Time-out capabilities (TIMER keyword 
parameter) 
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Reference 


10.8.6 
Section 4 
Section 9 
Figure 4-1 
4.] 

42 

93 

9.4 


4.2 
6.2.1.2 
3.2 
42 
4.2 


42 


3.1 
3.3.6 
2.2 
14.1 
1.3.1 


2.2 
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Term 


Track mode settings 

9-track 

7-track 
TRANS keyword parameter 

SUPGEN 

NTRGEN 
Transient work areas 
TRANSLAT keyword parameter 
TRNADR keyword parameter 
TRNWKAREA keyword parameter 
TRUNC keyword parameter 
TYPE keyword parameter 


|/OGEN 
NTRGEN 


Unit numbers, logical 
Upgrade existing software 
methods 
SYSGEN operation 
to new OS/3REL volume 
to new SYSRES volume 
User LCB/VFB 


Users, integration, new or existing 


UTS 400 modules, RESGEN 
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Table 3-2 
Table 3-3 


2.2 
7.2.2 
22 


3.3.6 


3.3.1 
12.2 


Table 3-1 


14.2.1 
1.4.3 
10.7.1.3 
10.7.1.3 
10.7.1.5 


3.3.2 


1.4.2.1 


Page 


3-11 


1-14 
1-17 
10-19 
10-19 
10-20 


3-13 


1-14 


Term 


VALIDITY keyword parameter 
punch 
reader 


Verify system build modules, RESGEN 


Verify system installation (IVP) 


Vertical format buffer (VFB) 
job control statements 
keyword parameter 
OWNVF1 
printer keyword parameters 


SYSGEN operating procedures 


VFBDEN keyword parameter 
VFBFORM keyword parameter 
VFBHOME keyword parameter 
VFBLEN keyword parameter 
VIRTUAL keyword parameter 
printer 
punch 
reader 
VLINE macroinstruction 
VOLTABLE keyword parameter 
Volume serial number 
SPOOLVSN parameter 
SYSOUT keyword, RESGEN 


Volume table of contents (VTOC) 


Workstation format, 1/OGEN 


WORKSTATION keyword parameters 
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4.2 
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33:2 
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122 
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7.2.2 
7.2.2 
3.3.2 
3.3.4 
3.3.3 


6.2.2 
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1.3.1 
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